---
title: "The Crunch assistant"
url: "/docs/crunch-assistant"
canonical_url: "https://crunchjunkie.io/docs/crunch-assistant"
markdown_url: "https://crunchjunkie.io/docs/crunch-assistant.md"
language: "en"
type: "doc"
summary: "Meet Crunch — the in-app helper that explains your data and answers product how-tos."
site: "CrunchJunkie"
llms_txt: "https://crunchjunkie.io/llms.txt"
---

# The Crunch assistant
Source: https://crunchjunkie.io/docs/crunch-assistant

Meet Crunch — the in-app helper that explains your data and answers product how-tos.

## What Crunch is
Crunch is the assistant built into CrunchJunkie. It does two jobs. First, it's context-aware: it knows which screen you're on and can explain the data in front of you — what a metric means, why a number moved, what a chart is showing — so you can get an answer without leaving the page. Second, it answers product how-to questions from this documentation, so "how do I schedule a report?" or "how do I add a secondary dimension?" gets a direct, accurate reply drawn straight from these guides.

Think of it as a knowledgeable colleague who has read the manual and is also looking over your shoulder at the exact report you're working on.

Crunch can also read your own workspace to answer a question the current page can't: list your clients, check which sources are connected, pull a report's live numbers or an AI-visibility trend. While it does, the chat shows each step as it happens — "Listing your clients", "Pulling live report data" — and the finished answer keeps that list under "What Crunch checked", so you can see exactly what it was grounded in. These lookups only ever read; asking a question never changes anything. When Crunch runs on our AI key, each plan includes a monthly number of assistant messages (Solo 150, Starter 400, Pro 1,000, Agency 2,500; trial 60) — answers, report analysis and the automatic report summary count together. The count is under Settings → Billing; on your own AI key there is no cap.

## Opening Crunch
There are two ways in. The "Ask Crunch" button in the topbar is always available, and the floating Crunch mascot in the corner of the screen opens the same assistant. Either one drops you into a chat where you can type a question in plain language.

To get you started, Crunch offers suggestion chips — one-tap prompts relevant to the page you're on — so you can often get an answer without typing at all. Ask follow-ups freely; the conversation keeps its context as you go.

Anything you find yourself typing more than once — "draft the monthly client update", "add conversions by campaign" — can be saved: click **Save prompt** under a message you sent, and it becomes a chip above the composer for everyone in your workspace (up to 30). One click drops it into the box; the small × removes it.

## Asking good questions
For how-to questions, ask the way you'd ask a colleague: "how do I white-label my reports?", "what's the difference between BYO keys and Managed AI?", "why don't my AI visibility results match what I see in ChatGPT?". Crunch answers these from the documentation, so the reply matches what's published here.

For data questions, ask about what's on screen: "why did ROAS drop this month?", "what does engaged sessions mean?", "which campaign drove the most conversions?". Because Crunch can see the page context, it can ground its answer in your actual numbers rather than speaking in generalities.

## Asking about one specific widget
Inside a report, hover any chart, table or breakdown — or a single KPI card — and click the small Crunch icon to "Ask about this". The assistant opens focused on just that widget, and answers only from its numbers: the exact values, their deltas versus the comparison period, and the timeframe shown. A banner tells you which widget is in focus, and one click ("Ask about the whole report instead") widens the scope back.

This keeps answers precise — ask "what changed and why?" on a single chart and Crunch reads only that chart's data. If a widget's data can't answer your question, Crunch says so plainly rather than guessing or pulling in unrelated numbers.

## Ask Crunch to build a widget
Inside a report you can ask Crunch to add a widget in plain language instead of dragging one from the palette. Type what you want — "add a table of our top campaigns by ROAS", "break LinkedIn down by seniority", "show conversions by device as a donut", "add a monthly cost and conversions table for the last year", or "show the top Meta ads with their images" — and Crunch builds that widget straight into the report, against live data. You can also upload a screenshot of a widget (from another tool, a slide, or a competitor's report) and Crunch will reproduce the closest version it can from your connected data.

Editing works the same way: describe the change to an existing widget — "make the sessions chart weekly", "show it for last quarter", "turn the donut into a bar chart", "remove it". Every change is validated against the same catalog (an impossible ask is refused with the reason, never a silently wrong widget), answered with a receipt of exactly what changed, and undoable with one click right in the chat. To skip the guessing entirely, hover any data widget in the report and click its pencil: Crunch opens already pointed at that widget, so the instruction needs no title — "make it weekly" changes exactly the widget you clicked.

Sections work the same way: "add a section called Paid Media above the Google Ads table", "rename the first section to Overview", "move the SEO section to the end", "remove the Awareness section but keep its widgets". A section carries its widgets with it when it moves, removing one keeps its widgets unless you say otherwise, and the receipt says exactly what moved where — with a one-click Undo that restores the previous layout.

Crunch is grounded in the same vetted, per-source catalog as Draft with AI, so it only ever builds things that actually exist for your connected sources — it never invents a metric, dimension or data source. That means one of four honest outcomes: it adds the widget; it tells you the data source you need isn't connected for this client yet (with where to connect it); it flags that the specific metric or breakdown you asked for isn't something CrunchJunkie builds yet — in which case it notifies our team automatically so we can add it — or, if you asked a question rather than gave an instruction, it just answers. Either way you never get a widget full of fabricated numbers.

## Escalating to support
Crunch handles the how-tos and the explanations, but some things need a human — a billing query, an account-specific problem, or anything the docs can't answer. When that happens, use the Contact support option in the assistant; it sends your message to our team by email, so you don't have to switch apps to get help. Our team is small and replies fast, usually within a few hours. Crunch knows its limits, and handing you to a person when needed is part of the design.
