---
title: "Installation"
manual: "Universal Messenger"
version: "main"
permalink: "https://docs.typo3.org/permalink/universal_messenger:installation@main"
source: "Installation/Index.rst"
rendered: "2026-10-07T12:03:11+00:00"
---

# Installation {#installation}

## Composer {#installation-composer}

Install the extension via Composer:

**Install the extension**

```bash
composer require netresearch/universal-messenger
```

Activate the extension in the **Admin Tools > Extensions** backend
module if your installation does not activate required extensions
automatically.

## Update the database structure {#installation-database}

The extension adds the newsletter page type and its channel-selection
field to the `pages` table. Open **Admin Tools > Maintenance**
and run **Analyze Database Structure** to add the missing fields.

## Site configuration {#installation-site-configuration}

The extension ships its default TypoScript two ways, so no manual
"include static template" step is required for either kind of site:

-   **Classic sites** (`sys_template` based) receive the default
    TypoScript automatically through a global TypoScript registration.
-   **Site Set based sites** load the same TypoScript by adding
    `netresearch/universal-messenger` to the site's Set dependencies.

**config/sites/\<site-identifier>/config.yaml**

```yaml
dependencies:
  - netresearch/universal-messenger
```

Two additional static templates provide the Fluid rendering of the
newsletter content and an example newsletter page template. Include them
as described in [TypoScript](https://docs.typo3.org/permalink/universal_messenger:configuration-typoscript@main).

After installation, continue with [Configuration](https://docs.typo3.org/permalink/universal_messenger:configuration@main) to set up the
Universal Messenger webservice credentials.