---
title: "Upgrade"
manual: "LIA Usercentrics"
version: "1.2"
permalink: "https://docs.typo3.org/permalink/lia_ext/lia_usercentrics:upgrade@1.2"
source: "Upgrade.rst"
rendered: "2026-10-16T12:57:53+00:00"
---

# Upgrade {#upgrade}

## Upgrade to 1.2.0 {#upgrade-to-1-2-0}

Version 1.2.0 adds the
[consent integration](https://docs.typo3.org/permalink/lia_ext/lia_usercentrics:consent-integration-configuration@1.2) and fixes
settings that had no effect before. Check these points when you update an
existing project.

-   **`excludedPages` takes effect**

    Before version 1.2.0, the constant was ignored. Pages in this list are now
    rendered without Usercentrics: no banner, no blocking, YouTube and Vimeo
    videos load directly. Clear the constant if your project relied on the
    previous behavior.

-   **`ucQueryParameter` takes effect**

    A request with `?uc=<value>` now renders the page without Usercentrics.
    Keep the value secret or clear the constant. Requests with `uc` bypass
    the page cache. Add `uc` to
    `$GLOBALS['TYPO3_CONF_VARS']['FE']['cacheHash']['excludedParameters']`.

-   **YouTube and Vimeo iframes are only blocked with a blocking mechanism**

    The renderers output `uc-src` only when `useSmartDataProtector` or
    `useConsentIntegration` is enabled. Before, videos never loaded when
    both were disabled.

-   **YouTube and Vimeo iframes keep their attributes**

    When Usercentrics is active, the iframes now keep attributes like
    `width`, `height` and `allow`. Before, the attributes were dropped.
    Check the video layout, especially CSS that compensated for the missing
    attributes.

-   **Invalid `customOverlayIntegration` entries throw an exception**

    Each entry must have the format `<TemplateID>:<target>` with the
    characters `A-Z`, `a-z`, `0-9`, `_` and `-`. Before, the Smart
    Data Protector skipped invalid entries silently.

-   **TypoScript values are type-checked**

    A value of the extension with the wrong type, for example an array instead
    of a string, throws an exception instead of being ignored.

See [Basic configuration](https://docs.typo3.org/permalink/lia_ext/lia_usercentrics:basic-configuration@1.2) for `excludedPages` and `ucQueryParameter`.