🧩 How to Generate Schema Markup

Camilo Aponte

Camilo Aponte

Last updated on Nov 4, 2026

πŸ“Œ What schema markup does

Schema markup is structured data that describes a page in a format search engines can read. It does not replace your visible content. It labels that content, such as an article, product, FAQ, organization, or local business, so search engines can understand it more clearly and may show richer results.

In Search Atlas, schema is generated for a crawled page inside an OTTO project. Review the result before you deploy it, and make sure every value matches what visitors can see on the page.

βœ… Before you generate schema

  • Open the correct Search Atlas project for the website.
  • Choose one page and confirm its title, URL, and main topic.
  • Pick the schema type that matches the page. Do not use product schema on a blog post or FAQ schema unless the page shows real questions and answers.
  • Have accurate details ready, such as business name, author, price, or location, if the page includes them.

πŸ› οΈ Generate schema in Search Atlas

  1. Sign in to Search Atlas and open your project.
  2. In the OTTO project, open Schema Markup and find the page under Page-Level Schemas.
  3. Open Schema Markup in the OTTO project. Domain-Level Schema covers the sitewide organization schema, and Page-Level Schemas lists each page URL.
  4. OTTO selects the schema type from the page summary. If none is available, it uses the default for that page type. You can change only the sitewide organization type under Domain-Level Schema.
  5. Review the fields Search Atlas fills in. Edit any value that is missing, outdated, or different from the live page.
  6. On the page-level schema row, select Generate schema, or Regenerate schema if content already exists. Search Atlas fills in JSON-LD, the format most search engines expect.
  7. Read the generated markup once more. Copy it from the schema view, or deploy that schema with Deploy this Schema.

Important: Only include facts that appear on the page. Misleading schema can cause search engines to ignore the markup.

πŸš€ Add the markup to your site

To deploy a schema, select Deploy this Schema, or Deploy as-is if Search Atlas warns that validation issues remain, then confirm the change on the live URL. If you copy the markup instead, paste the JSON-LD into the page head inside a script tag with type application/ld+json, or into your site's structured data field, then publish the page.

  • Use one clear schema type for the page's main purpose.
  • Keep the script intact. Do not remove brackets or quotes.
  • Update the markup whenever the visible page details change.

πŸ” Check that it works

  1. Open the published page and confirm the content matches the schema.
  2. Test the URL in Google's Rich Results Test or another public schema validator.
  3. Fix any errors the test reports, regenerate or edit the markup, and test again.
  4. Allow time for search engines to recrawl the page. Validation does not guarantee a rich result will appear.

πŸ’‘ Fix common schema issues

  • Wrong type: Generate the type that matches the page, then replace the old markup.
  • Missing fields: Add the missing visible information on the page first, then regenerate.
  • Old details: Update the page and schema together so prices, dates, and names stay accurate.
  • Duplicate markup: Keep one current JSON-LD block for the same schema type so the signals do not conflict.

πŸ’¬ Get help in the platform

If you need further assistance, open the chat widget in the bottom-right corner of the platform and send your message. A member of our support team will reply in the chat.

Was this article helpful?