---
title: "TypoScript to Backend Module"
manual: "Auth0 for TYPO3"
version: "13.0"
permalink: "https://docs.typo3.org/permalink/leuchtfeuer/auth0:migrations-backendmodule@13.0"
source: "Migrations/BackendModule.rst"
rendered: "2026-09-25T07:34:30+00:00"
---

# TypoScript to Backend Module {#migrations-backendmodule}

If you update this extension from a version lower than 3.3.0, you must follow these steps to get rid of obsolete TypoScript
settings.

1.  Make your TypoScript available for the backend module

    The TypoScript settings of both `plugin.tx_auth0.settings.roles` and
    `plugin.tx_auth0.settings.propertyMapping` has to be available for the backend module. You can archive this by
    adding following lines of TypoScript at the bottom of your TypoScript template:

    ```typoscript
    module.tx_auth0.settings.roles < plugin.tx_auth0.settings.roles
    module.tx_auth0.settings.propertyMapping < plugin.tx_auth0.settings.propertyMapping
    ```
1.  Migrate the role mapping

    Navigate into the Auth0 backend module and click on the "configure" button in the "Roles to Groups"
    card. There should be an info box on top of the content. Click on the "Import configuration from TypoScript" button. After
    the page refreshed, the module will output the configuration migrated from you TypoScript.

    ![The backend module.](../Images/migrate-backend-module.png)
1.  Migrate the property mapping

    Select the "Property Mapping" option of the select box on top of the page and proceed as described in 2.
1.  Unset your TypoScript

    Open your TypoScript template and unset the former configuration:

    ```typoscript
    plugin.tx_auth0.settings.roles >
    plugin.tx_auth0.settings.propertyMapping >
    ```

    Do not forget to remove the configuration you made in 1. Afterwards the info boxes in the backend module will disappear.