---
title: "Site Settings"
manual: "Frontend Edit"
version: "2.6"
source: "Configuration/SiteSettings.rst"
rendered: "2026-10-01T07:11:45+00:00"
---

# Site Settings {#site-settings}

All configuration options are managed via TYPO3 Site Settings.
This provides site-specific configuration and better caching behavior.

Configuration is done in your site's `config/sites/<site-identifier>/settings.yaml` file
or via the TYPO3 backend in **Site Management > Sites > Edit site > Settings**.

## Available Settings {#available-settings}

### Enable/Disable {#enable-disable}

-   **frontendEdit.enabled**

    -   *type:* bool
    -   *Default:* true

    Enable or disable the frontend editing functionality for this site.

    ```yaml
    frontendEdit:
      enabled: true
    ```

### Appearance Settings {#appearance-settings}

-   **frontendEdit.colorScheme**

    -   *type:* string
    -   *Default:* 'auto'

    Choose the color scheme for the frontend editing UI. Options: auto (follows system preference), light, dark.

    ```yaml
    frontendEdit:
      colorScheme: 'auto'
    ```

-   **frontendEdit.showContextMenu**

    -   *type:* bool
    -   *Default:* true

    Show the Edit Menu with additional actions (edit page, hide, move, history). Disable to show only the edit button.

    ```yaml
    frontendEdit:
      showContextMenu: true
    ```

-   **frontendEdit.showInsertButtons**

    -   *type:* bool
    -   *Default:* true

    <!-- TODO: no Markdown rendering for "versionadded" -->

    Show the `+` buttons above and below each content element on hover to insert a
    new element before or after it via the New Content Element Wizard. This setting
    also controls the **New content after** entry in the Edit Menu. Disable to hide
    both.

    ```yaml
    frontendEdit:
      showInsertButtons: true
    ```

-   **frontendEdit.showStickyToolbar**

    -   *type:* bool
    -   *Default:* true

    Show the Toolbar with page editing options and toggle functionality.

    ```yaml
    frontendEdit:
      showStickyToolbar: true
    ```

-   **frontendEdit.toolbarPosition**

    -   *type:* string
    -   *Default:* 'bottom-right'

    Choose the position for the Toolbar.

    Available options:

    -   `top-left`, `top-center`, `top-right`
    -   `bottom-left`, `bottom-center`, `bottom-right`
    -   `left-top`, `left-center`, `left-bottom`
    -   `right-top`, `right-center`, `right-bottom`

    ```yaml
    frontendEdit:
      toolbarPosition: 'bottom-right'
    ```

-   **frontendEdit.enableOutline**

    -   *type:* bool
    -   *Default:* true

    Show an outline around content elements when hovering over them.

    ```yaml
    frontendEdit:
      enableOutline: true
    ```

-   **frontendEdit.enableScrollToElement**

    -   *type:* bool
    -   *Default:* true

    Automatically scroll to the edited content element after saving and returning to the frontend.

    ```yaml
    frontendEdit:
      enableScrollToElement: true
    ```

-   **frontendEdit.enableContextualEditing**

    -   *type:* bool
    -   *Default:* false

    <!-- TODO: no Markdown rendering for "versionadded" -->

    > [!NOTE]
    > This feature is **experimental**.

    Enables [Inline Editing](../Usage/InlineEditing.html#inline-editing): content element and page property edit forms
    open in a panel next to the page instead of navigating to the backend.

    The setting is required on **all supported TYPO3 versions** — it also gates
    the New Content Element Wizard used by [Column Targets](../Integration/ColumnTargets.html#empty-columns). Only the
    presentation differs and is chosen automatically: a sidebar panel on
    TYPO3 v14.2+ (native `record_edit_contextual` route), a slide-in modal on
    TYPO3 v13 and v14.0/v14.1.

    See [Inline Editing](../Usage/InlineEditing.html#inline-editing) for details on how to use this feature.

    ```yaml
    frontendEdit:
      enableContextualEditing: true
    ```

-   **frontendEdit.enableDragAndDrop**

    -   *type:* bool
    -   *Default:* false

    <!-- TODO: no Markdown rendering for "versionadded" -->

    > [!NOTE]
    > This feature is **experimental**.

    Allows editors to reorder content elements by dragging them within a column
    or into another column of the same page. The move is persisted through the
    core DataHandler.

    Requires your Fluid template to mark each column with the
    `ColumnTargetViewHelper`; without those markers no drag handle is
    rendered. Columns of EXT:container elements are supported when the template passes
    `containerUid`. Translated elements and nesting a container inside another
    container keep the backend move dialog.

    See [Drag & Drop Reordering](../Usage/DragAndDrop.html#drag-and-drop) for details on how to use this feature.

    > [!NOTE]
    > **See also**
    >
    > [Column Targets](../Integration/ColumnTargets.html#empty-columns) describes the required template markers.

    ```yaml
    frontendEdit:
      enableDragAndDrop: true
    ```

-   **frontendEdit.markerBasedDetection**

    -   *type:* bool
    -   *Default:* false

    <!-- TODO: no Markdown rendering for "versionadded" -->

    > [!NOTE]
    > This feature is **experimental**.

    Wraps every rendered content element in invisible HTML comment markers, so
    elements become editable even when their template renders neither a c-id
    nor a `data-frontend-edit` attribute.

    See [Alternative: render markers (experimental)](../Integration/TemplateRequirements.html#render-markers) for how the markers work and where they reach
    their limits.

    ```yaml
    frontendEdit:
      markerBasedDetection: true
    ```

-   **frontendEdit.enableFlashMessages**

    -   *type:* bool
    -   *Default:* true

    Show TYPO3 flash messages (e.g., save confirmations) as toast notifications in the frontend
    after returning from the backend. When you use "Save & Close" in the backend, success or
    error messages will be displayed as notifications in the frontend.

    ![Flash message notification in frontend](../Images/flash-message.png)

    ```yaml
    frontendEdit:
      enableFlashMessages: true
    ```

### Filter Settings {#filter-settings}

-   **frontendEdit.filter.ignorePids**

    -   *type:* string
    -   *Default:* ''

    Comma-separated list of page IDs (and their subpages) where frontend editing should be disabled.

    ```yaml
    frontendEdit:
      filter:
        ignorePids: '1,2,3'
    ```

-   **frontendEdit.filter.ignoreDoktypes**

    -   *type:* string
    -   *Default:* ''

    Comma-separated list of page types (doktype) where frontend editing should be disabled.
    Common doktypes: 1 (Standard), 3 (External URL), 4 (Shortcut), 6 (Backend User Section), 7 (Mount Point), 199 (Menu Separator), 254 (Folder), 255 (Recycler).

    ```yaml
    frontendEdit:
      filter:
        ignoreDoktypes: '4,199,254'
    ```

-   **frontendEdit.filter.ignoreCTypes**

    -   *type:* string
    -   *Default:* ''

    Comma-separated list of content types (CType) to exclude from frontend editing.

    ```yaml
    frontendEdit:
      filter:
        ignoreCTypes: 'html,div'
    ```

-   **frontendEdit.filter.ignoreListTypes**

    -   *type:* string
    -   *Default:* ''

    Comma-separated list of plugin types (list_type) to exclude from frontend editing.

    ```yaml
    frontendEdit:
      filter:
        ignoreListTypes: 'news_pi1'
    ```

-   **frontendEdit.filter.ignoreUids**

    -   *type:* string
    -   *Default:* ''

    Comma-separated list of specific content element UIDs to exclude from frontend editing.

    ```yaml
    frontendEdit:
      filter:
        ignoreUids: '100,200,300'
    ```

## Example Configuration {#example-configuration}

Full example with all available options:

**config/sites/my-site/settings.yaml**

```yaml
frontendEdit:
  enabled: true
  colorScheme: 'auto'
  showContextMenu: true
  showInsertButtons: true
  showStickyToolbar: true
  toolbarPosition: 'bottom-right'
  enableOutline: true
  enableScrollToElement: true
  enableFlashMessages: true
  enableContextualEditing: false
  enableDragAndDrop: false
  filter:
    ignorePids: '1,2,3'
    ignoreDoktypes: '4,199,254'
    ignoreCTypes: 'html,div'
    ignoreListTypes: ''
    ignoreUids: ''
```