---
title: "Installation"
manual: "Universal Messenger"
version: "3.1"
permalink: "https://docs.typo3.org/permalink/universal_messenger:installation@3.1"
source: "Installation/Index.rst"
rendered: "2026-11-05T12:11:25+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@3.1).

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