---
title: "Installation"
manual: "Laposta"
version: "main"
permalink: "https://docs.typo3.org/permalink/proudnerds/laposta:installation@main"
source: "Installation/Index.rst"
rendered: "2026-09-17T13:58:03+00:00"
---

# Installation {#installation-1}

Target group: **Administrators / Integrators**

1.  Install the extension: `composer require proudnerds/laposta`.
1.  Coming from 12.x: run the upgrade wizard *Migrate "Proudnerds Laposta" plugins to
    content elements* in the Install Tool. It converts the existing content elements
    from `CType=list` to their own content types and updates the backend user group
    permissions.
1.  Include the TypoScript template.
1.  Add the extension to the relevant backend user groups.
1.  Add the Laposta `apiKey` in the constants settings.
1.  Create "Laposta newsletter list" records.
1.  Insert the subscribe and unsubscribe plugins on your pages.
1.  Select the "Laposta newsletter list" records on each plugin.
1.  Set the record storage page to the page that holds the list records.
1.  On laposta.nl you can add custom fields per newsletter. The template ships with
    email (required), voornaam and achternaam.
1.  Add or change custom fields in the template by prefixing the field name with
    `customField.`.
1.  A log is kept in `var/log/Laposta.log`.

![The Laposta newsletter subscription form in the TYPO3 frontend](../Images/Laposta.png)