Create your first prompt
Open the Prompts page
Navigate to Dashboard → Prompts in the sidebar. If you have no prompts yet, you will see an empty state with a Create prompt button. Click it to open the prompt form.
Name your prompt
Enter a short, descriptive label in the Name field. This name appears in the run history and dashboard charts — it is for your reference only and is not sent to any LLM. Example:
Best project management tools.Write the prompt text
In the Query field, enter the question exactly as a user might type it into ChatGPT or Perplexity. Write the query in natural language; do not reference your brand name in the query itself, since the goal is to see whether AI models surface your brand unprompted.Good examples:
What are the best tools for tracking brand visibility in AI search?Which platforms help with generative engine optimization?What should I use to monitor how my company appears in ChatGPT?
Set brand details
Enter your Brand name — the exact name Rankahead should look for in AI responses. Optionally enter your Brand domain (e.g.,
rankahead.ai) to enable domain-level citation tracking alongside keyword mentions.Choose a locale
Select the Locale that matches your target market. Locale affects how queries are interpreted by LLMs that support multilingual inputs. The default is
en-US.Set a schedule
Enter a cron expression in the Schedule field to run this prompt automatically. Leave it blank to run manually only. See cron schedule examples below for reference.
Prompt fields reference
Name
Name
A human-readable label for the prompt. Used in the run list, dashboard charts, and gap analysis views. Keep it short and descriptive so you can identify it at a glance.
Query text
Query text
The exact question sent to each LLM provider. Write it in natural language as a user would, without mentioning your brand. The same query text is used for every provider, ensuring consistent comparisons across LLMs.
Brand name
Brand name
The name Rankahead searches for in each AI response. This should match how your brand is commonly referenced — for example,
Rankahead rather than Rankahead Inc.. The match is case-insensitive.Brand domain
Brand domain
Optional. When provided, Rankahead also checks whether AI responses include links or references to your domain. This feeds into the Citations dashboard.
Schedule (cron expression)
Schedule (cron expression)
A standard five-field cron expression that controls when the prompt runs automatically. See cron schedule examples below. Leave empty to disable automatic scheduling.
Locale
Locale
The language and region context for the prompt. Affects response language on providers that support locale-aware queries. Examples:
en-US, en-GB, fr-FR, de-DE.Active
Active
When toggled off, the prompt is paused. Scheduled runs are skipped and the prompt does not appear in visibility score calculations. You can reactivate it at any time without losing run history.
Cron schedule examples
The schedule field accepts standard cron syntax:minute hour day-of-month month day-of-week.
| Expression | Schedule |
|---|---|
0 9 * * 1 | Every Monday at 9:00 AM UTC |
0 9 * * 1,4 | Every Monday and Thursday at 9:00 AM UTC |
0 0 * * * | Daily at midnight UTC |
0 9 1 * * | First day of every month at 9:00 AM UTC |
0 */6 * * * | Every 6 hours |
Running a prompt manually
To trigger a run immediately without waiting for the next scheduled time, open the prompt’s detail page and click Run now. The run is queued instantly and typically completes within 30–90 seconds depending on provider response times. You can run a prompt manually even if it has no schedule set. This is useful for one-off checks after publishing new content or after a competitor announcement.Reading run results
Click any row in the run list to open the full result detail. Runs are listed most recent first and paginated in groups of 20. Each run shows:- Status:
PENDING,RUNNING,COMPLETED, orFAILED - Started at and completed at timestamps
- LLM results: The raw response from each provider, with brand mentions highlighted
- Brand analysis: A summary of how the brand was referenced — mentioned, not mentioned, or cited as a source
- Keyword suggestions: Topics and keywords that appeared in AI responses that your brand could better target
- LLM responses
- Brand analysis
- Keyword suggestions
Each provider’s response is shown in full, with your brand name highlighted wherever it appears. If your brand is not mentioned, the response is still shown so you can see how AI models are answering the query and which competitors or sources they reference instead.
Managing multiple prompts
As you scale your tracking, you will likely accumulate prompts across different topic areas, product lines, or markets. A few practices to keep things organized:- Use consistent naming conventions — for example, prefix by category:
[Product] Best CRM tools,[Brand] What is Rankahead? - Disable prompts for topics you are no longer actively targeting rather than deleting them; this preserves historical run data
- Group similar queries together by locale to track regional differences in AI responses
- Review keyword suggestions across runs regularly — they are one of the fastest ways to discover new content opportunities
Each prompt runs against all LLM providers simultaneously. If you have four providers configured, one prompt run generates four LLM responses. Your plan’s run quota is measured per LLM response, not per prompt.