Install

Works with Drupal: ^11.2

Using Composer to manage Drupal site dependencies

Alternative installation files

Download tar.gz 28.42 KB
MD5: 968f9adf868e9cb51da41835d26b0b04
SHA-1: c673cc82e74da0732efd69795d8a30682a0be322
SHA-256: 037843e997152b70cf772166e8cc26f35cebcc15af5ed8598e71efd1d2e6e2ac
Download zip 46.57 KB
MD5: 6cae9b4de2c28297186ea1f1e6bde4e4
SHA-1: 8a9e068506f813d0d5147ae0836dfb256a329f9f
SHA-256: 22839a4956e71eb9bc7ed5548d6e11ded6831b7f4a81ce899db7f2d1f78298c0

Release notes

First alpha of the 3.x branch. 3.x requires Drupal 11.2 or newer and PHP 8.3 or newer. For Drupal 10 or Drupal 11.0–11.1, keep using 2.x.

This is an alpha release: test it on a copy of your site first. Please report problems in the issue queue. Plan: #3628891.

Upgrading from 2.x

  • Update the code, then run the database updates (drush updatedb). They convert the stored settings to the new types. Check the settings page afterwards.
  • The "Display mode" setting is removed.
  • "Timeout" and "Max width" are required. Font sizes are numbers from 1, or empty for the default size.
  • The toast titles are new translatable strings: "Success", "Error" and "Warning". If you translated the old strings, translate the new ones.
  • Theme overrides of izi-message.html.twig should use the new status_headings variable for the titles.
  • drupalSettings.iziMessage is only on pages that load the toast library.
  • For developers: izi_message.module is removed (hooks are in src/Hook), IziMessageSettingsForm::SETTINGS is removed, and IziMessage is no longer a render element class.

New features

  • #3628902: Show JS messages (Drupal.Message, for example from AJAX forms) as toasts
  • #3628903: Install iziToast with Composer (libraries/iziToast or libraries/izitoast)
  • #3629354: Announce server messages to screen readers; hide them with the hidden attribute

Bug fixes

  • #3628897: Settings changes do not reach cached pages
  • #3628898: Settings form shows wrong defaults; use #config_target
  • #3628899: Fix config schema types and add update hook
  • #3628900: Toast titles cannot be translated

Tasks

  • #3628893: Require Drupal ^11.2 and PHP 8.3
  • #3628894: Add GitLab CI
  • #3628895: Replace deprecated requirements and render element APIs
  • #3628896: Convert hooks to OOP hook classes
  • #3628901: Add test coverage
  • #3628904: Update README and help page for 3.x

Known limitations

  • Without JavaScript, server messages are not shown.
  • The settings are the same for all requests; configuration overrides per request are not supported.

Contributors

usingsession

Created by: usingsession
Created on: 8 Oct 2026 at 15:05 UTC
Last updated: 8 Oct 2026 at 15:05 UTC
Bug fixes
New features

Other releases