Documentation
Everything you need to run scans and improve how AI models represent your brand.
New to LumaRank? Start with Getting started to run your first scan, then read How AI-visibility scoring works to understand the numbers behind your AI Visibility and SEO Health scores.
When you’re ready to act, Adding llms.txt and ai.txt walks through the highest-leverage technical wins. Below the guides, the reference covers every feature in depth, grouped by area.
Getting started with LumaRank
From sign-up to your first AI-visibility + SEO scan in a few minutes: companies, projects, prompts and the dashboard.
How AI-visibility scoring works
What goes into your AI Visibility and SEO Health scores: mention rate, position, authority, off-site presence, AI signals and SEO categories.
Adding llms.txt and ai.txt to your site
A practical guide to publishing llms.txt, ai.txt and an AI-friendly robots.txt so models read and represent your brand correctly.
Getting started
- How LumaRank works
The big picture: how companies, projects and scans fit together.
- Downloadable reports
Export any scan or project as a polished PDF: executive, action plan, competitive, or AI sources.
- Signing in and creating an account
Sign in with Google or a password, confirm your email, and what to do if it never arrives.
- One brand or your clients: choosing an account type
Which account type fits you, what changes between them, and how to switch later.
- The onboarding walkthrough
What happens when you first set up your account and brand.
Companies & Projects
- Companies vs Projects
A company is your brand; projects are the working units beneath it.
- Editing your company settings
Update your domain, brand, industry, competitors and target markets.
- Creating and managing projects
Add projects to track different angles, segments or experiments.
- The base project (and why it's read-only)
Every company has one base project that mirrors its brand settings.
Team & collaboration
Prompts & categories
- What prompts are and why they matter
Prompts are the questions we ask AI assistants on your behalf.
- Prompt categories explained
The five built-in categories, custom prompts, plus grouping by topic and audience segments.
- Generating prompts with AI
Let LumaRank draft a starter set of prompts from your brand details.
- Editing, regenerating and deleting prompts
Refine your prompt set so scans ask exactly the right questions.
- Why a prompt may not fit its category
What the category warning means and how to resolve it.
- Reading a prompt's performance over time
Track how each prompt performs across your scans.
Running scans
- Creating and running an scan
Set the scope and run an scan step by step.
- Scan statuses
What running, completed and failed mean for an scan.
- Re-running and comparing scans
Re-run an scan to measure the impact of your changes.
- Refreshing a single prompt
Re-run one prompt or Run fresh to update the current view, and what each costs.
- Refreshes and how runs are billed
What a refresh is, which runs use one, and when your allowance resets.
- Scheduling scans and email alerts
Run scans automatically on a cadence and get emailed when things change.
- Scheduled monitoring and refreshes
Why scheduled monitoring is included, and how it differs from refreshes.
- The Monitoring tab
One place to see and control the three automatic tracks that keep a project fresh.
- Your email digest
A recap email of how your brands are doing, across every company and project.
AI Visibility results
- What the AI Visibility score reflects
How to read your AI Visibility score and the signals behind it.
- The Actions view
One prioritized list of everything to improve, each traced to its source.
- Guided mode
One fix at a time, with the steps, instead of a list to choose from.
- Content briefs
Turn a measured gap into what a page must cover, plus a prompt for your own AI assistant.
- How estimated impact is calculated
What the "up to +X pts" on each action means and how to read it.
- The per-provider breakdown
See how each AI assistant talks about your brand.
- Sentiment and citations
How positive the mentions are, what AI praises or criticizes, and which sources back them up.
- Sources the AI retrieved
The real pages the AI pulled up while answering, and how to use them to get mentioned.
- Brand facts and wrong-fact detection
Enter facts about your brand; we flag AI answers that get them wrong and show the source.
- Authority: being a go-to source
Why AI recommends some brands as top choices, and how to earn that trust.
- Brand understanding
How accurately AI describes what you do, and how to sharpen it.
- Answer position: winning the top spot
Being named is step one; where you land in the list is what turns it into a choice.
- Visibility by AI engine
Why one assistant names you often and another rarely, and what to do about each.
- Tracking your actions and progress
Mark what you are working on, and see what improved over time, newest first.
- Owned vs earned citations
Why leaning only on your own site is fragile, and how to declare your other domains.
- Consistency: staying cited over time
How steady your AI visibility is scan to scan, per engine, and how to make it durable.
- Comparing against competitors
See where you stand next to the competitors you track.
- The per-prompt (query) breakdown
Drill into how your brand did on each individual prompt.
- How your results stay current
Why paid plans reflect today’s web and the free plan uses a static snapshot.
- The current visibility view
The live current snapshot vs your trend history, and how they update.
- Tracking competitors
Rivals and the free watchlist, adding competitors per project, letting LumaRank suggest and auto-find them, and how many each plan tracks.
- Competitor opportunities
Where a competitor is ahead of you (SEO or AI visibility) and what to do to close each gap.
- LLM optimization signals
The on-site signals that help AI assistants find, read and describe your brand.
SEO scan
- Reading the SEO health score
What the SEO health score covers and how to read it.
- What each SEO category checks
A plain-language guide to every SEO category we check.
- Content relevance and topic gaps
Whether your pages target the keywords and topics you want to be found for.
- Branded search results
Where your site ranks when someone searches your brand name.
- Competitor SEO benchmark
Compare your SEO health against the competitors you track.
- SEO quick wins
The fastest, highest-impact fixes to act on first.
- When your site blocks AI crawlers
Why a robots.txt rule can keep you out of AI answers, and how to fix it.
Keyword tracking
Off-site presence
- Off-site presence and share of voice
Why mentions across the web shape how AI talks about you.
- The presence sources on your dashboard
What each presence source tells you about your reach.
- Understanding share of voice
How your slice of the conversation is measured against rivals.
- Where to get mentioned
High-leverage places to be present on, tuned to your industry.
Trends & overview
- Your project Home (the monitor)
The live monitor for a project: freshness, current score, trend and scans.
- The Trends view (scores over time)
See how your scores move over time across all your scans.
- Building a custom dashboard
Pick the metrics you care about, arrange them, and share the board.
- The metric views
A guided tour of each dedicated metric view.
- Date range, excluding scans and the competitor selector
Shape your charts to focus on the period and rivals that matter.
- Template changes on your timeline
Markers that show when you changed your brand or prompt setup.
AI providers
Plans & billing
- Plans and what each limit means
Compare plans: prompts, projects, competitors, monitoring frequency and refreshes.
- Usage and the monthly reset
Track your refreshes and know when your allowance resets.
- Buying more refreshes
Top up with a refresh pack when you run low before the monthly reset.
- Upgrading, downgrading and checkout
How to change plans and what happens at checkout.
- White-label reports
Put your own logo, color and name on the PDF reports you share with clients.
Trash & data
Troubleshooting
- Reset your password
Send yourself a link to set a new password, and what to do when the link stops working.
- Why a scan won't run
The Run / Refresh button is disabled or a run was rejected: the common reasons and fixes.
- If your account is paused for review
What a paused account means, what it affects, and how to appeal.
- Keeping prompts genuine (acceptable use)
What prompts are for, what to avoid, and what happens if a prompt looks like misuse.