How to add schema markup (structured data) to your pages

Schema markup (also called structured data) is hidden code, in a format called JSON-LD, that tells Google and AI assistants what a page is about: your business, a product, a blog post or a list of questions and answers. It can help your pages show richer results. TeleportHQ publishes schema markup on every page for you. To give a page its own, open its Page SEO Settings, go to Schema markup and click Generate schema markup to have AI write it from the page, or edit the code yourself. Then publish.

Before you start#

• Schema markup is available on every TeleportHQ plan.
• Generate schema markup uses AI tokens. TeleportHQ needs at least 500 available AI tokens for each page it writes, and charges what the AI really used. See What uses AI tokens, and how much?.
• Writing schema markup with AI needs the Owner, Admin or Designer role. The Editor role can't. See What can each role do?.
• Schema markup reaches your site when you publish with TeleportHQ, and it's in the Next.js and React code downloads. The HTML download and the other code formats don't include it.

What TeleportHQ publishes for you#

Without any setup, every TeleportHQ page publishes schema markup built from the page and your site settings:

• On every page: your organization, your website and the page itself.
• On pages other than the home page: a breadcrumb trail (for example Home › Cakes) and what the page shows: a product on a product page, a blog post or a help article, or a list on a list or category page.
• On a page with a FAQ: a page that says "FAQ" or "Frequently asked questions" and has at least two questions, each ending with "?" and followed by its answer, also publishes them as a FAQ.

The details about your business come from your project:

• Name and description: the Meta Title and Meta Description in Project settings → SEO & social → Search engines. Without a Meta Title, your project's name is used.
• Logo: your favicon, or else your social sharing image. See How to change your project's name and favicon.
• Email address and phone number: your store's company details, or else the first email and phone links on your site.
• Address and VAT number: your store's company details.
• Social profiles: the links to social networks on your pages, navigation and footer.

Write a page's schema markup with AI#

1. In the left sidebar, click the layers icon (tooltip Pages, Components & Tree View).
2. In the Pages list, right-click the page. You can also click the … button at the end of its row.
3. Click Page SEO Settings. A panel named after the page opens, for example About Settings.
4. Scroll to Schema markup, below Open Graph Settings. The JSON-LD schema box shows the schema the page publishes now, with placeholders such as {{@siteName}} where your business details go.
5. Click Generate schema markup. TeleportHQ reads the page and writes its schema with AI. "Schema markup generated from the page content." appears, and the box shows the new schema.
6. Publish your site. See How to publish your site.

The same section is also above the canvas: with the page open, click Page settings at the top right of the canvas, then SEO.

A schema of the page's own replaces the automatic one completely: TeleportHQ doesn't publish both.

Edit the schema markup yourself#

You can change the code in the JSON-LD schema box, or replace it with your own. TeleportHQ saves it a moment after you stop typing.

• Check the code as you type. Mistakes are listed under the box with their line, for example "Line 3: …". While the code has errors, "The automatic schema is published until this is fixed."
• Tidy it. Prettify lays out the code neatly. Line wrapping wraps long lines.
• Get more room. The button next to Generate schema markup (tooltip Open in a larger editor) opens the code in a large Schema markup (JSON-LD) window. Your changes are kept when you close it.
• Use placeholders. Under Placeholders, click one to put it where your cursor is. {{@siteUrl}} is your site's address and {{@pageUrl}} the page's, so the schema follows a domain change. The other {{@site…}} placeholders are your business's name, logo and contact details, filled in each time you publish. On a page that shows one item from your data, such as a product or a blog post, the list is called Placeholders and record fields and also has the item's fields, for example {{name}}.

Under the code, a line says where the schema comes from: "Automatic: built from this page and your site settings. Edit it, or generate one with AI, to publish your own.", or for example "Generated with AI · Oct 22, 2026" or "Edited by hand · Oct 22, 2026".

When a page changes after its schema was written#

TeleportHQ remembers what a page said when its schema was written. When about 30% of the page's text has changed, or the page no longer says something the schema states (for example a price), Schema markup shows a warning icon and a notice such as "This schema is out of date. About 40% of the page changed since this schema was written." You can then:

• click Regenerate to write a new schema with AI. It uses AI tokens and replaces the current schema, even one you edited by hand;
• click Mark as up to date if the schema is still right. It uses no AI tokens.

Keep schema markup up to date automatically#

The Keep Schema Markup Up To Date switch is in Project settings → SEO & social → Search engines, below Use Self Canonical URLs. It's on by default. It says: "Before each publish or code export, pages whose AI-written schema markup (Page settings › Schema markup) no longer matches their content get a new one, written with AI from the page. Uses AI tokens, and is skipped while your workspace does not have enough. Schema markup you edited by hand is never replaced: you are told which pages to review."

While the switch is on, TeleportHQ looks for AI-written schemas that fell behind their page each time you:

• publish your site,
• download your code as Next.js or React,
• open Code with Next.js or React selected,
• export to GitHub as Next.js or React.

For each such page, it writes a new schema with AI before the code is built. This spends AI tokens: it needs at least 500 available tokens for each page, and stops when your workspace has fewer. You see "Updating out-of-date schema markup on 2 pages…", then "Schema markup updated on 2 pages." Pages it couldn't update keep their current schema. Pages with No Index on, pages only signed-in visitors can open and sites hidden from search engines are skipped. To stop these updates, turn the switch off. You can still click Generate schema markup or Regenerate yourself.

Go back to the automatic schema markup#

1. In the page's Schema markup section, click Use the automatic schema. The Delete schema markup window opens: "The page publishes its automatic schema again. You can undo this."
2. Click Delete.
3. Publish your site.

Check that it worked#

In the editor, the Schema markup section lists no mistakes, and its last line says "Generated with AI" or "Edited by hand" with the date. After you publish, test the page's live address with Google's Rich Results Test, or open the page's source in your browser and look for application/ld+json. Google decides on its own whether to show a rich result, and it can take days or weeks.

Troubleshooting#

"You do not have enough tokens to generate schema markup." Your workspace has fewer than 500 AI tokens available. Buy more tokens or wait for your monthly tokens. See What happens when I run out of AI tokens?.

"Could not generate schema markup. Please try again." Click Generate schema markup again. If it keeps failing, check your role: writing schema markup with AI needs the Owner, Admin or Designer role.

"The automatic schema is published until this is fixed." The code in the JSON-LD schema box has a mistake. Fix the lines listed under it, or click Use the automatic schema.

"Schema markup you edited may be out of date on About. Review it in Page settings › Schema markup." TeleportHQ shows this before a publish or a code export. It never replaces a schema you edited by hand. Open that page's Schema markup, then edit the code, click Regenerate, or click Mark as up to date.

"Could not update the schema markup of About; the current schema is used instead." The automatic update didn't work for that page. Your site still publishes the page's current schema. Open the page's Schema markup and click Regenerate.

A page has no Schema markup section The 404 page and admin panel pages don't have one. Pages whose address is made for each visitor, such as an order page, don't either.

"No Index is on for this page, so search engines do not read its schema." The page asks search engines not to list it, so its schema has no effect. A similar note shows on pages only signed-in visitors can open, and when the whole site is hidden from search engines. See How to hide a page from Google, set a canonical URL or redirect a page.

Good to know#

• Opening the code view can use AI tokens. With Keep Schema Markup Up To Date on, opening Code with Next.js or React selected updates out-of-date AI-written schemas first. See How to view your site's code.
• HTML downloads have no schema markup. Only TeleportHQ hosting and the Next.js and React code include it. See How to download your site as code (React, Next.js, Vue, HTML and more).
• Changing your business details doesn't need a new schema. Placeholders like {{@siteName}} are filled in each time you publish, so a new logo or phone number reaches every page at your next publish.
• Site Health checks your home page for schema markup. Without any, an audit lists "No structured data (JSON-LD) found — it helps search engines and AI show rich results". See How to check your site's SEO health.