---
title: "Installation"
manual: "Contexts"
version: "4.0"
source: "Installation/Index.rst"
rendered: "2026-10-07T05:17:05+00:00"
---

# Installation {#installation}

## Requirements {#installation-requirements}

| Extension Version | TYPO3 | PHP |
| --- | --- | --- |
| 4.x | 12.4 LTS, 13.4 LTS | 8.2 - 8.5 |
| 3.x | 11.5 LTS | 7.4 - 8.1 |

The recommended way to install this extension is via Composer.

## Installation via Composer {#installation-composer}

```bash
composer require netresearch/contexts
```

After installation, activate the extension in the TYPO3 Extension Manager or
via CLI:

```bash
vendor/bin/typo3 extension:activate contexts
```

## Site Set Configuration (TYPO3 v13+) {#installation-site-set}

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

Site Sets support for TYPO3 v13.

For TYPO3 v13 and later, you can include the Contexts site set in your site
configuration:

1.  Go to **Site Management > Sites**
1.  Edit your site configuration
1.  In the **Sets** tab, add "Contexts - Multi-channel content visibility"

Alternatively, add it to your site's `config/sites/<identifier>/config.yaml`:

```yaml
imports:
  - { resource: "EXT:contexts/Configuration/Sets/Contexts/config.yaml" }
```

## Classic TypoScript Include (TYPO3 v12+) {#installation-classic}

For traditional TypoScript setup, include the static template:

1.  Go to **Web > Template**
1.  Select your root page
1.  Edit the template record
1.  In **Includes**, add "Contexts" to the selected items

## Database Updates {#installation-database}

After installation, run the database analyzer to create required tables:

```bash
vendor/bin/typo3 database:updateschema
```

Or use the **Admin Tools > Maintenance > Analyze Database Structure**
module in the TYPO3 backend.

## Verification {#installation-verification}

After installation, you should see:

1.  A new "Contexts" module in the backend (under Admin Tools)
1.  "Context visibility" options in page and content element properties
1.  Database tables: `tx_contexts_contexts`, `tx_contexts_settings`