---
title: "Typoscript Reference"
manual: "powermailcaptcha"
version: "3.4"
permalink: "https://docs.typo3.org/permalink/thomasrawiel/powermailcaptcha:typoscript@3.4"
source: "Configuration/TyposcriptReference.rst"
rendered: "2026-10-13T12:04:32+00:00"
---

# Typoscript Reference {#typoscript}

> [!IMPORTANT]
> Make sure powermail spamshield is enabled:
>
> ```php
> plugin.tx_powermail.settings.setup.spamshield._enable = 1
> ```

This is an overview of the available Typoscript constants. They are also available in the Constant Manager.

-   [Enable / disable](https://docs.typo3.org/permalink/thomasrawiel/powermailcaptcha:enable-disable@3.4)
-   [Sitelanguage](https://docs.typo3.org/permalink/thomasrawiel/powermailcaptcha:sitelanguage@3.4)
-   [Captcha API Keys](https://docs.typo3.org/permalink/thomasrawiel/powermailcaptcha:captcha-api-keys@3.4)
-   [Additional configuration for friendlycaptcha](https://docs.typo3.org/permalink/thomasrawiel/powermailcaptcha:additional-configuration-for-friendlycaptcha@3.4)
-   [Additional configuration for Google recaptcha v3](https://docs.typo3.org/permalink/thomasrawiel/powermailcaptcha:additional-configuration-for-google-recaptcha-v3@3.4)

## Enable / disable {#enable-disable}

-   **plugin.tx_powermailcaptcha.enable**

    -   *Type:* bool
    -   *Default:* true

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

    In case you wish to disable the captcha temporarily, just add the following line to your typoscript constants:
    `plugin.tx_powermailcaptcha.enable = 0`

    You can also find this option in the Constant Editor.

## Sitelanguage {#sitelanguage}

-   **plugin.tx_powermailcaptcha.useSiteLanguage**

    -   *Type:* bool
    -   *Default:* true

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

    The current language is added to the captcha via language parameter which is taken from your Site Configuration.

    To disable this behavior, add the following to your Typoscript Constants:

    `plugin.tx_powermailcaptcha.useSiteLanguage = 0`

## Captcha API Keys {#captcha-api-keys}

-   **plugin.tx_powermailcaptcha.captchaMethod**

    -   *Type:* string
    -   *Required:* true

    Available values:

    -   Google Recaptcha v2 (Checkbox) `recaptcha`
    -   Google Recaptcha v3 `recaptcha3`
    -   Friendly Captcha v1 `friendlycaptcha`
    -   Friendly Captcha v2 `friendlycaptcha2`
    -   hCaptcha `hcaptcha`
    -   Cloudflare Turnstile `cloudflare`
    -   Prosopo Procaptcha `procaptcha`

    See [Supported Captcha Types](https://docs.typo3.org/permalink/thomasrawiel/powermailcaptcha:captchatypes@3.4)

-   **plugin.tx_powermailcaptcha.sitekey**

    -   *Type:* string
    -   *Required:* true

    Captcha Sitekey/ Application ID

-   **plugin.tx_powermailcaptcha.secretkey**

    -   *Type:* string
    -   *Required:* true

    Captcha Secretkey / API key

## Additional configuration for friendlycaptcha {#additional-configuration-for-friendlycaptcha}

-   **plugin.tx_powermailcaptcha.endpoint**

    -   *Type:* string
    -   *Default:* default

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

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

    As a premium feature friendlycaptcha offers a dedicated endpoint hosted in Germany as an additional guarantee that the personal information (i.e. visitor IP addresses) never leave the EU

    To use the EU-endpoint change the value to `eu`

    Allowed values: `default|eu`

    Available for both v1 and v2

## Additional configuration for Google recaptcha v3 {#additional-configuration-for-google-recaptcha-v3}

-   **plugin.tx_powermailcaptcha.minScore**

    -   *Type:* number
    -   *Default:* 0.8

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

    Defines the minimum score required for a reCAPTCHA v3 response to be considered legitimate.

    reCAPTCHA v3 assigns a score between 0.0 and 1.0 to indicate the likelihood that an interaction is legitimate. Higher scores indicate a higher likelihood of a human interaction, while lower scores indicate a higher likelihood of a bot.

    See the [Google reCAPTCHA v3 documentation](https://developers.google.com/recaptcha/docs/v3#interpreting_the_score) for details on interpreting scores.

-   **plugin.tx_powermailcaptcha.action**

    -   *Type:* string
    -   *Default:* powermail_form_submit

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

    Defines the expected action name for the reCAPTCHA v3 response. The returned action must match this value for the response to be considered valid.

    See the [Google reCAPTCHA v3 documentation](https://developers.google.com/recaptcha/docs/v3#actions) for details on action names and verification.