---
title: "Configuration"
manual: "schema"
version: "main"
permalink: "https://docs.typo3.org/permalink/brotkrueml/schema:configuration@main"
source: "Configuration/Index.rst"
rendered: "2026-09-27T17:05:57+00:00"
---

# Configuration {#configuration}

Target group: **Developers, Integrators**

**Table of Contents**

-   [Extension configuration](https://docs.typo3.org/permalink/brotkrueml/schema:extension-configuration@main)

## Extension configuration {#extension-configuration}

To configure the extension, go to
**Admin Tools > Settings > Extension Configuration** and click on the
**Configure extensions** button. Open the **schema**
configuration:

![Options in the extension configuration](../Images/Configuration/ExtensionConfiguration.png)

### Automatic embedding of the WebPage schema into the page {#configuration-automaticwebpageschemageneration}

If this option is enabled, the `WebPage` type schema is automatically embedded
into the page. The web page type can be defined in the field
**Specific type of web page** of the [page properties](https://docs.typo3.org/permalink/brotkrueml/schema:for-editors@main)
and defaults to [WebPage](https://docs.typo3.org/permalink/brotkrueml/schema:web-page-type@main).

-   **Default value**

    enabled

### Automatic embedding of the breadcrumb markup into the page {#configuration-automaticbreadcrumbschemageneration}

If this option is enabled, the breadcrumb is automatically generated from the
rootline of the current page.

-   **Default value**

    disabled

> [!NOTE]
> Since multiple breadcrumbs are allowed for a page, this option adds a
> breadcrumb to the possibly already existing ones (for example, defined via
> the [API](https://docs.typo3.org/permalink/brotkrueml/schema:breadcrumb-api@main) or the
> [view helpers](https://docs.typo3.org/permalink/brotkrueml/schema:breadcrumb-viewhelpers@main)).

> [!TIP]
> **Hint**
>
> When using [Yoast SEO for TYPO3](https://extensions.typo3.org/extension/yoast_seo),
> this extension also adds a breadcrumb by default to the website. To avoid
> duplicate JSON-LD markup, you can disable the breadcrumb markup generated
> by Yoast SEO for TYPO3 extension with this TypoScript snippet:
>
> ```typoscript
> config.structuredData.providers.breadcrumb >
> ```
>
> See also the [Structured data chapter](https://docs.typo3.org/p/yoast-seo-for-typo3/yoast_seo/main/en-us/Configuration/StructuredData/Index.html#structureddata) in
> the Yoast SEO for TYPO3 manual.

### Automatic embedding of the breadcrumb markup into the page - Exclude additional doktypes {#automatic-embedding-of-the-breadcrumb-markup-into-the-page-exclude-additional-doktypes}

If the option [Automatic embedding of the breadcrumb markup into the page](https://docs.typo3.org/permalink/brotkrueml/schema:configuration-automaticbreadcrumbschemageneration@main) is
enabled, you can define additional doktypes, which will be excluded from the
breadcrumb. Separate multiple doktypes with commas.

The doktypes 199 (spacer), 254 (folder) and 255 (recycler) are always excluded.

-   **Default value**

    (empty)

### Allow only one breadcrumb list {#allow-only-one-breadcrumb-list}

With enabled option only one breadcrumb list will be rendered. This may be
helpful, if the option [Automatic embedding of the breadcrumb markup into the page](https://docs.typo3.org/permalink/brotkrueml/schema:configuration-automaticbreadcrumbschemageneration@main)
is enabled and you want to overwrite the generated breadcrumb list on a
dedicated page with a custom one.

### Embed markup on "noindex" pages {#configuration-embedmarkuponnoindexpages}

If this option is enabled, the schema markup is embedded also on "noindex"
pages.

-   **Default value**

    enabled

> [!NOTE]
> The option is considered only if the [SEO system extension](https://docs.typo3.org/c/typo3/cms-seo/14.3/en-us/Introduction/Index.html#introduction) is installed. If this is not the case, the markup is
> always embedded.
