---
title: "Configure extension"
manual: "mosparo integration for EXT:form and Extbase-based forms"
version: "1.1"
permalink: "https://docs.typo3.org/permalink/denkwerk/mosparo-form:configure-setup-mosparo@1.1"
source: "Configuration/Configure-extension.rst"
rendered: "2026-11-11T13:09:55+00:00"
---

# Configure extension {#configure-setup-mosparo}

-   [Configure the mosparo Form via site set settings (TYPO3 v13 and above)](https://docs.typo3.org/permalink/denkwerk/mosparo-form:configure-the-mosparo-form-via-site-set-settings-typo3-v13-and-above@1.1)
-   [Configure the mosparo Form via TypoScript (TypoScript File)](https://docs.typo3.org/permalink/denkwerk/mosparo-form:configure-the-mosparo-form-via-typoscript-typoscript-file@1.1)
-   [Configure the mosparo Form via TypoScript (Constants Editor)](https://docs.typo3.org/permalink/denkwerk/mosparo-form:configure-the-mosparo-form-via-typoscript-constants-editor@1.1)

> [!TIP]
> Before configuring the extension, make sure that mosparo is [set up](https://documentation.mosparo.io/docs/category/installation) and a [project](https://documentation.mosparo.io/docs/usage/projects#create-a-project) has been created.

## Configure the mosparo Form via site set settings (TYPO3 v13 and above) {#configure-via-site-set}

You can configure [projects](https://documentation.mosparo.io/docs/usage/projects) and validation settings through the [Site settings editor](https://docs.typo3.org/m/typo3/reference-coreapi/14.3/en-us/ApiOverview/SiteHandling/SiteSettingsEditor.html#site-settings-editor) in the TYPO3 backend.

1.  Got to module **Site Management > Settings** and edit your site configuration.
1.  Under the category "mosparo Form" you can than enter your project configuration.

![Site settings for mosparo forms](../_Images/site_settings_projects.png)

### Environment variables in site settings {#configure-via-site-set-env}

Site settings are defined in [`config/sites/my-site/settings.yaml`](https://docs.typo3.org/m/typo3/reference-coreapi/14.3/en-us/Administration/DirectoryStructure/SiteFolder.html#file-site-config-sites-my-site-settings-yaml), where [environment variables](https://docs.typo3.org/m/typo3/reference-coreapi/14.3/en-us/Administration/Deployment/EnvironmentStages/Configuration/Index.html#environment-configuration) can be used to provide the mosparo configuration.

**config/sites/my-site/settings.yaml (diff)**

```diff
 plugin:
   tx_mosparoform:
     settings:
       projects:
         default:
+          publicServer: '%env(MOSPARO_FORM_DEFAULT_PUBLIC_SERVER)%'
+          verifyServer: '%env(MOSPARO_FORM_DEFAULT_VERIFY_SERVER)%'
+          uuid: '%env(MOSPARO_FORM_DEFAULT_UUID)%'
+          publicKey: '%env(MOSPARO_FORM_DEFAULT_PUBLIC_KEY)%'
+          privateKey: '%env(MOSPARO_FORM_DEFAULT_PRIVATE_KEY)%'
```

### Site set settings to configure the extension {#configure-site-set-settings}

-   **mosparoForm**

    -   *Label:* Mosparo form

    -   **mosparoForm.general**

        -   *Label:* General

        -   **plugin.tx_mosparoform.settings.defaultProject**

            -   *Type:* `string`
            -   *Default:* `"default"`
            -   *Label:* Default project
            -   *Category:* Mosparo form > General

            Default mosparo project configuration that is used.

    -   **mosparoForm.projects**

        -   *Label:* Projects

        -   **mosparoForm.projects.default**

            -   *Label:* Default

            -   **plugin.tx_mosparoform.settings.projects.default.publicServer**

                -   *Type:* `string`
                -   *Label:* Public server
                -   *Category:* Mosparo form > Projects > Default

                Host of your mosparo installation, which is used in the frontend

            -   **plugin.tx_mosparoform.settings.projects.default.verifyServer**

                -   *Type:* `string`
                -   *Label:* Verify Server
                -   *Category:* Mosparo form > Projects > Default

                Host of your mosparo installation, which is used at the backend verification

            -   **plugin.tx_mosparoform.settings.projects.default.uuid**

                -   *Type:* `string`
                -   *Label:* UUID
                -   *Category:* Mosparo form > Projects > Default

                Unique identification number of the project in mosparo

            -   **plugin.tx_mosparoform.settings.projects.default.publicKey**

                -   *Type:* `string`
                -   *Label:* Public key
                -   *Category:* Mosparo form > Projects > Default

                Public key of the project in mosparo

            -   **plugin.tx_mosparoform.settings.projects.default.privateKey**

                -   *Type:* `string`
                -   *Label:* Private key
                -   *Category:* Mosparo form > Projects > Default

                Private key of the project in mosparo

## Configure the mosparo Form via TypoScript (TypoScript File) {#configure-via-typoscript}

You can add the settings over a TypoScript file like this:

**EXT:site_package/Configuration/TypoScript/constants.typoscript**

```typoscript
plugin.tx_mosparoform.settings {
    defaultProject=<Default mosparo project configuration that is used>

    projects {
        default {
            publicServer=<Host of your mosparo installation, which is used in the frontend>
            verifyServer=<Host of your mosparo installation, which is used at the backend verification>
            uuid=<Unique identification number of the project in mosparo>
            publicKey=<Public key of the project in mosparo>
            privateKey=<Private key of the project in mosparo>
        }
    }
}
```

## Configure the mosparo Form via TypoScript (Constants Editor) {#configure-via-typoscript-constants-editor}

The settings for the [projects](https://documentation.mosparo.io/docs/usage/projects) and validation themselves can be set via the [Submodule "Constant Editor"](https://docs.typo3.org/m/typo3/reference-typoscript/14.3/en-us/UsingSetting/Entering.html#constant-editor).

1.  This can be opened under the **Sites > TypoScript** module using the **Constant Editor**.
1.  You only have to select the entry “mosparo form” under **Selected category** in the editor.