Skip to main content
Every page with an optimized version gets a citability score, shown as a percentage. It tells you how well the page is structured for an answer engine to read and quote, and points you to what to fix.

Where to find it

1

Open Agent Analytics

Go to Agent Analytics in the Bluemoon app and select your domain.
2

Open your pages

Click See all pages, then the Your pages tab. Each page shows its status (Optimized, Stale, Not generated or Error) and its citability score. A page with no score, for example one marked Error, shows a dash instead of a number.
3

Open a page

The page view shows How citable this page is and the Citability factors behind it: Title, Lead / answer, Section headings, FAQ structured data, Freshness date and Enough content.

How to read the score

The score rates the structure of the optimized version of your page: whether it has the elements that make content easy to lift and cite. It does not:
  • predict or count citations. To see whether served pages are actually cited, use Pages served to AI, later cited in Agent Analytics;
  • reflect your ranking in traditional search. A page can rank well on Google and score low here, or the other way round.

How to improve your score

Answer engines find it easier to quote pages that are clearly written and split into self-contained sections. The changes below make your page easier to read and cite, and raise its score.
Adding JSON-LD structured data to your page does not change the score: the optimized version comes with its own structured data. Work on the content and structure of the page instead.

Give the page a clear title

Make sure every page has a descriptive <title>.

Lead with a direct answer

Write your meta description as a direct answer to the page’s main question, not a marketing tagline. Put the same answer in your first paragraph too. Before:
Since the early days of the internet, caching has been an important topic for developers…
After:
Browser caching stores copies of static assets locally so that repeat visitors load your site faster without re-fetching unchanged files from your server.

Split the page into sections

Use <h2>/<h3> headings, each followed by a paragraph. Self-contained sections are easier for an answer engine to quote.

Phrase a heading as a question

Rewrite a section heading as a question (ending with ?) and answer it in the paragraph right below. You don’t need a separate FAQ block.
A few tightly written questions on the page’s core topic work better than a long list of loosely related ones.

Show when the page was updated

Add an article:modified_time meta tag or a <time datetime="..."> element.

Keep enough substantial content

Short, thin pages score lower. Pages with too little text get no optimized version at all.
The optimized version only reorganizes what is already on your page. To raise the score, improve the page itself, then regenerate.

Regenerate after you update a page

The score reflects the current optimized version, not your live page. Editing your page does not change the score until the optimized version is rebuilt.
1

Update your page

Publish the changes on your site as usual.
2

Click Regenerate

In Agent Analytics, open the page under See all pages → Your pages and click Regenerate. Bluemoon rebuilds it from your updated page and recomputes the score.
3

Check the new score

Once the rebuild is done, the status returns to Optimized and the new score appears in the list.

One score per URL

Each URL has its own optimized version and its own score. A canonical page and its translated version, for example, are scored separately, so improving one does not change the other. Use Most crawled pages in Agent Analytics to prioritize the pages that get the most AI crawler traffic.