---
title: "Site settings"
manual: "How to Document"
version: "main"
permalink: "https://docs.typo3.org/permalink/h2document:reference-site-settings"
source: "Reference/ReStructuredText/Code/SiteSettings.rst"
rendered: "2026-09-24T12:09:25+00:00"
---

# Site settings {#reference-site-settings}

When an extension features [Settings definitions](https://docs.typo3.org/m/typo3/reference-coreapi/main/en-us/ApiOverview/SiteHandling/SiteSets/Index.html#site-sets-settings-definition)
for site settings these can be automatically documented by including the settings
definition file. The special syntax `PROJECT:` can be used to load the file
from the directory of the extension instead of the `Documentation` folder only.

**Settings.rst**

```rst
..  typo3:site-set-settings:: PROJECT:/Configuration/Sets/MySet/settings.definitions.yaml
    :name: my-set
    :type:
    :Label: max=30
    :default: max=10

```

-   **\_global**

    -   **website.background.color**

        -   *Type:* `color`
        -   *Default:* `"#129845"`
        -   *Label:* Background color

        This will validate the given color string

    -   **website.image.lazyLoading**

        -   *Type:* `string`
        -   *Default:* `"lazy"`
        -   *Label:* Browser-native image lazy loading
        -   *Enum:* { "lazy": "Lazy", "eager": "Eager", "auto": "Auto" }

        Can be "lazy" (browsers could choose to load images later), "eager" (load images right away) or "auto" (browser will determine whether the image should be lazy loaded or not)

    -   **website.rte.allowTags**

        -   *Type:* `string`
        -   *Default:* `"a, abbr, acronym, address, article, aside, b, bdo, big, blockquote, br, caption, center, cite, code, col, colgroup, dd, del, dfn, dl, div, dt, em, figure, font, footer, header, h1, h2, h3, h4, h5, h6, hr, i, img, ins, kbd, label, li, link, meta, nav, ol, p, pre, q, s, samp, sdfield, section, small, span, strike, strong, style, sub, sup, table, thead, tbody, tfoot, td, th, tr, title, tt, u, ul, var"`
        -   *Label:* List of allowed HTML tags when rendering RTE content

The custom parameters `:type:`, `:Label:` etc can be used to configure
which aspects of the settings should be shown in the overview table.

A `:name:` can be used to create a namespace when there are several sets. All
links to the configuration values will be prefixed then.