Help Docs

Schema

Improve your site's Organization schema so search and AI identify your brand.

Averi automatically reads the Organization schema (structured data) from your website and audits it so you know exactly what search engines and AI systems can see about your brand. You don't need to add or edit schema inside Averi — the audit shows you what's there, what's missing, and what to fix on your site.

Where to find it

In the left sidebar under Foundations, click Sitemap. If Averi detects Organization schema on your site, you'll see a Schema tab alongside Health Check, Breakdown, and Recommendations.

The Schema tab only appears when Averi finds Organization structured data on your site. If you don't see it, your site may not have Organization schema set up yet — ask your developer to add it.

What is schema and why does it matter

Schema (also called structured data or JSON-LD) is a behind-the-scenes code snippet on your website that tells search engines and AI exactly who your organization is. Think of it as a machine-readable business card — it includes things like your company name, website, logo, social profiles, and founding details.

When your schema is complete and accurate:

  • Search engines can display rich results like knowledge panels with your logo, social links, and company info.
  • AI systems (like ChatGPT, Perplexity, and Google's AI Overviews) can correctly identify and cite your brand.
  • Entity recognition improves — search engines connect your brand across platforms and build a stronger understanding of who you are.

When schema is missing or incomplete, search engines have to guess, and they often get it wrong.

Understanding your audit

The audit view scores your Organization schema and groups the fields into four tiers.

Your score and level

At the top, you'll see a score ring and a level badge labeled Your Current Level. The five levels are:

  • Comprehensive — Your schema covers all key identity and authority signals.
  • Strong — Core identity is solid; adding authority signals will improve entity recognition in AI search.
  • Foundation — Basic identity fields are present, but key authority signals are missing.
  • Minimal — Only basic fields detected; search engines and AI have limited ability to identify your brand.
  • Incomplete — Critical schema properties are missing.

If there are improvements to make, you'll also see a Next step recommendation below the summary.

The four tiers

Each tier is an expandable section that lists individual fields. Every field shows a status dot and a badge — Found, Missing, or Partial — so you can see at a glance what needs attention.

The essentials: your organization Name, URL, Logo, and Description. These are the most important fields to get right.

Signals that help search engines connect your brand across the web: Same as (links to your social and directory profiles), @id (a unique identifier for your entity), Founding date, and Founding location.

The Same as row shows badges for each social profile Averi found (LinkedIn, YouTube, Instagram, etc.) and dashed suggestions for high-value platforms you're missing. Averi recommends linking at least four profiles.

Fields that build credibility: Founder (names and job titles), Award (recognitions), and Contact point (email or phone number).

Nice-to-haves that round out your profile: Alternate name (abbreviations or alternate brand names), Number of employees, and Knows about (topics your organization is associated with).

What to do with missing or incorrect fields

Schema lives in your website's code, not inside Averi, so fixing it means updating the JSON-LD on your site. Here's how to work through it:

  1. Start with the Next step recommendation. Averi prioritizes what to fix first based on impact, so follow that guidance.
  2. Use the copy helpers. Switch to the raw view by clicking Raw Schema at the top of the card. You'll see two buttons:
    • Copy current — copies your schema exactly as it is today.
    • Copy with missing fields — copies your schema with placeholder templates filled in for every missing field, so you can see the structure you need.
  3. Hand it to your developer (or paste it into your site's code yourself if you're comfortable editing HTML). The copied JSON-LD goes inside a <script type="application/ld+json"> tag, typically in the <head> of your homepage.
  4. Come back and re-check. After your site is updated, revisit Sitemap → Schema in Averi. Averi will re-read your site and update the audit.

Tips

  • Focus on Core Identity first. Name, URL, logo, and a solid description make the biggest immediate difference.
  • Link your social profiles. The more platforms you connect through the Same as field, the easier it is for search engines to verify your brand across the web.
  • Keep your description between 100–300 characters. Too short and it won't be useful; too long and search engines may ignore it.
  • Include founder job titles. Adding a title alongside each founder name helps search engines understand your org structure and connect your brand to Person entities.

Need Help?

Reach out to us at [email protected] - you'll always get a human to talk through solutions with.