---
title: "Troubleshooting"
manual: "AI Localization"
version: "main"
permalink: "https://docs.typo3.org/permalink/nitsan/ns-t3al:troubleshooting@main"
source: "Troubleshooting/Index.rst"
rendered: "2026-10-20T11:46:30+00:00"
---

# Troubleshooting {#troubleshooting}

## Frequently asked questions {#faq}

-   **Do I need a license key?**

    No. The extension is free. EXT:ns_license is only a required dependency
    and needs no activation.

-   **Which provider should I use?**

    Any provider with a valid API key works. DeepL and Google Translate are
    translation services; OpenAI and Gemini are language models and let you
    choose a model.

-   **Does Translate overwrite my existing translations?**

    No. Only empty translations are filled.

-   **Are the AI results saved automatically?**

    No. Review them in the grid and click **Save**.

-   **Can I upload my own extensions to Crowdin?**

    No. Crowdin upload only supports TYPO3 system extensions, see
    [Crowdin](https://docs.typo3.org/permalink/nitsan/ns-t3al:crowdin@main).

-   **Why does an editor not see any extension?**

    The extensions must be granted to the editor's backend user group, see
    [Access rights](https://docs.typo3.org/permalink/nitsan/ns-t3al:access-rights@main).

-   **Why can I not edit the English text of a system extension?**

    The English source files of TYPO3 system extensions are read-only. Only
    translations can be saved.

## Messages and solutions {#known-messages}

-   **`API key is missing` / `API key unavailable`**

    Add the API key of the selected provider in the
    [extension configuration](https://docs.typo3.org/permalink/nitsan/ns-t3al:configuration@main).

-   **`The translation service rejected the request (HTTP 401)`**

    The API key is invalid, the quota is used up, or the model is not
    available for your account. Check the key, quota and model.

-   **`Nothing to translate`**

    All labels in the selected languages already have a translation.

-   **`No changes`**

    The grid is identical to the files on disk; nothing was written.

-   **`Too many labels, max_input_vars too small`**

    Increase the PHP setting `max_input_vars` to at least the value shown
    in the message, or select fewer languages.

-   **Another user is editing the file**

    Another backend user opened the same file in the last 10 minutes. Agree
    who saves first to avoid overwriting each other's changes.

-   **The module is missing from the backend menu**

    Check that the extension is active and that your user or group has access
    to the module. Then clear all caches.