> For the complete documentation index, see [llms.txt](https://docs.premsoft.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.premsoft.de/en/plugins/seo-tools/management-dashboard/rich-snippets.md).

# Rich snippets

Structured data (Schema.org / JSON-LD) is extra information that makes your pages "machine-readable". It allows Google to show more than just a title and text in the search results – for example prices, availability, rating stars or expandable questions. Such **rich snippets** stand out and bring more clicks.

## Product, breadcrumb & organization schema (Basic)

**What is it good for?** These are the three most important base schemas:

* **Product** – price, availability and product data so Google can display them directly in the result.
* **BreadcrumbList** – shows the navigation path (e.g. *Home › Category › Product*) instead of the bare URL.
* **Organization** – details about your company (name, logo), the basis for the Google Knowledge Panel.

**How to use it:** Enable the three schemas in the [Configuration](/en/plugins/seo-tools/configuration.md#rich-snippets) and store the **company name** and **logo URL** there. The plugin then outputs the structured data automatically on all relevant storefront pages – you do not have to maintain anything per product.

## Extended schema types (Premium)

**What is it good for?** Beyond the basics there are schema types that unlock additional displays in Google for special content:

* **FAQ** – expandable questions and answers directly in the search result,
* **HowTo** – step-by-step instructions,
* **LocalBusiness** – details for local businesses (address, opening hours),
* **Event** – events with date and location.

**How to use it:** Per category or landing page you select the matching add-on type in the SEO tab and fill in the fields (e.g. questions/answers for the FAQ schema). The plugin produces the correct structured data from it.

## Variant schema & AggregateOffer (Premium)

**What is it good for?** Products with many variants (sizes, colours) have different prices. Instead of a single price, Google can show a **price range** ("from … to …"). Add to that extended details on shipping and returns, which Google increasingly requires for shopping results.

**How to use it:** For products with variants the plugin automatically generates an **AggregateOffer** with a price range. In the [Configuration](/en/plugins/seo-tools/configuration.md#rich-snippets) you additionally store **return** details (window, country, return shipping fees) and shipping details that feed into the schema.

## Schema validation (Premium)

**What is it good for?** Faulty structured data is ignored by Google – or triggers warnings in the Search Console. Instead of checking every product individually in Google's test tool, you check your entire catalogue in one go.

**How to use it:**

1. Open **SEO Tools → Schema check**.
2. Start the check. It runs **in the background** over all active products – a progress bar shows the status.
3. Afterwards you see a summary (valid / warnings / errors) and a **paginated list** of the flagged products with the specific hints.
4. Via **CSV export** you can hand the report over to your agency, for example, and with one click you jump straight to the affected product.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.premsoft.de/en/plugins/seo-tools/management-dashboard/rich-snippets.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
