> For the complete documentation index, see [llms.txt](https://docs.norrnext.com/norrcompetition/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.norrnext.com/norrcompetition/best-practices/use-on-multilingual-sites.md).

# Use on multilingual sites

NorrCompetition includes comprehensive multilingual support, enabling you to translate contest titles, categories, custom fields, and Grand Prix texts across all installed languages.

## Enabling Multilingual Support

1. Navigate to **Components > NorrCompetition > Options** (or click the **Options** toolbar button on any NorrCompetition admin view).
2. On the **General** tab, set the **Multilingual Support** parameter to `Yes`.
3. Save the configuration.

{% hint style="info" %}
**Requirements:** Multilingual operation requires PHP 8.2 or higher with the PHP `mbstring` and `intl` extensions enabled, along with configured Joomla Content Languages (**System > Languages > Content Languages**).
{% endhint %}

By default, multilingual support is disabled. Once enabled, edit forms for Contests, Categories, and Custom Fields display dedicated translation tabs for each installed Joomla content language.

## Admin Form Interface

When multilingual support is active, entity editing interfaces provide translation tabs:

<figure><img src="https://norrnext.com/images/docs/norrcompetition/multilingual/multilingual-contest-min.png" alt="NorrCompetition Contest form"><figcaption><p>Contest Form with multilingual translation tabs</p></figcaption></figure>

<figure><img src="https://norrnext.com/images/docs/norrcompetition/multilingual/multilingual-grand-prix-min.png" alt="Entry form"><figcaption><p>Entry Form Grand Prix description tabs</p></figcaption></figure>

<figure><img src="https://norrnext.com/images/docs/norrcompetition/multilingual/multilingual-field-min.png" alt="Field Form"><figcaption><p>Custom Field Form translation tabs</p></figcaption></figure>

<figure><img src="https://norrnext.com/images/docs/norrcompetition/multilingual/multilingual-category-min.png" alt="Category form"><figcaption><p>Category Form translation tabs</p></figcaption></figure>

## Best Practices for Multilingual Setup

{% hint style="warning" %}
**Category & Menu Language Assignment:**

* Create NorrCompetition categories with Language set to **All**. Do not restrict categories to a single language if they contain shared contests.
* When creating a menu item to *All Categories* or *Contest List*, set the menu item language to **All** unless you are creating dedicated menu trees per language in a multi-language Joomla setup.
  {% endhint %}

<figure><img src="https://norrnext.com/images/docs/norrcompetition/multilingual/multilingual-categories-menu-item-min.png" alt=""><figcaption><p>Menu item language configuration</p></figcaption></figure>

### Primary Language Notes

* The primary/fallback language corresponds to your site's default language (e.g. `en-GB`).
* Contestant user submissions (entry titles and custom field text values submitted by users) are stored as submitted. Translatable structural elements include contest descriptions, category titles, field labels, and administrative badges.