Docs menu

Knowledge

The pages Orvio read on your website, the brand model it built from them, and how to keep both current.

Knowledge is what Orvio knows about your company from your own website. It lists every page Orvio read and builds a brand model from them: what you sell, who you sell to and what you say about yourself.

What it shows

The page is titled Brand Knowledge. Under the title is one line saying how many pages were read, the language your prompts are in, and when the site was last read. The Re-index button beside it reads the whole site again.

Below that is the page list. It is laid out like folders on your site, starting at your domain. You can open a folder, go back up through the trail at the top, or search all pages by name. Each row shows:

  • Name: the page's title, with its path underneath.
  • Details: the kind of page (for example a product or pricing page), or why the page could not be read.
  • Status: Read, Failed or Blocked.

Choose a page to open its details: its status, its language, how many words it has, its page type, how Orvio found it, and when it was last read.

A brand that has never been read shows "Your Site Isn't Indexed Yet" and an Index site button instead.

How it is counted

What Orvio reads

Orvio reads your brand's main website only. Your other websites, listed in General, are never read.

Orvio starts from your homepage and sitemap and follows links. It reads like a browser does, so pages that build their content with scripts are read too. Pages your robots.txt rules out are not read. Files such as PDFs are not read either, so a fact that only appears in a PDF on your site is invisible to Orvio.

On a very large site Orvio reads the most important pages first: the pages linked from your navigation and footer, then product and service pages, then blog and news pages, newest first. It reads up to about 3,000 pages. When a site is larger than that, the least central pages are the ones left out.

What happens while it reads

Reading a site has three steps, and the line under the title names the one in progress:

  1. Reading your site: pages are fetched, with a progress bar. The total grows as Orvio finds more links, so the bar can move back a little.
  2. Sorting your pages by type and language: each page gets a page type and a language.
  3. Building your brand model: Orvio extracts what the site says about your company.

You can leave the page while this runs and come back later.

Where knowledge is used

  • Topics: Orvio proposes your first topics from what your site says, never from what engines already say about you. Otherwise the measurement would lean toward the visibility you already have. Each topic's site coverage is also checked against the pages read.
  • Prompts: prompts are drafted from your brand model, and the prompt review uses it to flag prompts that are off topic for you.
  • Your product names: product names found in your site's text count as other names for your brand when answers are read.
  • Fact checks: a fact engines state about you is verified against your site. Verifying opens only once your site has been read.
  • Investigations: an investigation takes what you sell and who you sell to from your brand model, and compares your pages with the pages engines cite instead.

When a brand is new, setup does not wait for the whole site to be read. It starts from a quick web read of your own domain, and the brand model takes over as soon as it is ready.

💡

Re-indexing updates your brand model. It does not rewrite your topics or prompts. Change those on their own pages.

How it stays current

Your site is not read again on its own. When your site changes, re-index it, so the brand model is rebuilt from the new pages.

Adding or re-reading a single page updates that page's text straight away. Fact checks read the new text, and so does site coverage for any topic you save from then on. The brand model itself is rebuilt only by a re-index. If a re-read fails on a page that was read before, Orvio keeps the earlier version.

How to read it

Re-index

Re-index reads every page of your site again. It takes a few minutes for most sites and up to a couple of hours for a very large one. Orvio asks before it starts, since it is the most expensive thing on this page. While it runs, the page list fills in as pages are read.

Prompt language

"prompts in" names the language your prompts are written in and engines are asked in. It was chosen when the brand was added and is fixed once setup is complete. It does not have to match your website. Pages written in another language carry a small language mark in the list.

Pages that couldn't be read

When some pages could not be read, a strip above the list says how many, with a Review button. Review shows only those pages, with the reason for each in the Details column:

  • Blocked by your site: your site refused the request, for example with a firewall or bot protection.
  • Couldn't be read: the page failed for another reason, such as an error or a timeout. The HTTP code is shown when there was one.

Try all again reads those pages again, up to 20 at a time. The strip hides while a re-index is running, since the run may fix them.

Add page

Add a page the index missed, or one you published since the last index. Type a full address or a path like /pricing. The page must be on your own domain. Adding is turned off while a re-index is running.

Re-read page and remove from index

From a page's details, Re-read page fetches that one page again; on a failed page the button reads Try again. Remove from index takes the page out and also keeps it out of every future index. An Undo appears for 15 seconds after you remove a page; undoing reads the page again and lifts the exclusion.