Issuu Embed Filter

The Issuu Embed Filter module provides a lightweight text filter for embedding
Issuu publications in Drupal content.

Content editors can insert an Issuu publication using a simple shortcode:

[issuu=document_identifier]

The filter converts the shortcode into a responsive Issuu iframe. The Issuu
username is configurable independently for each text format.

Features

• Embeds Issuu publications using a simple shortcode.
• Provides a configurable Issuu username for each text format.
• Generates responsive iframe markup.
• Generates accessible iframe titles from document identifiers.
• Supports Drupal 10 and Drupal 11.
• Has no contributed module dependencies.
• Does not require editors to paste iframe or JavaScript code.

Requirements

This module requires the Drupal core Filter module.

No third-party PHP libraries are required.

An Issuu account and published Issuu documents are required to display
publications.

Installation

Install the module using Composer:

composer require drupal/issuu_embed

Enable the module through the Extend administration page or
with Drush:

drush en issuu_embed

Configuration

1. Go to
   Configuration > Content authoring > Text formats and editors.
2. Edit the text format that should support Issuu embeds.
3. Enable the Issuu embed filter.
4. Enter the Issuu username that owns the publications.
5. Save the text format.

Usage

Add the following shortcode to formatted content:

[issuu=summer_guide_2026]

Replace summer_guide_2026 with the Issuu document identifier.

Similar projects and differences

• Issuu Viewer
  provides a dedicated field type for Issuu documents. Issuu Embed Filter
  works inside formatted text through Drupal's text filter system.
• Media Entity Issuu
  integrates Issuu publications with Drupal Media entities. Issuu Embed Filter
  does not create entities and is intended for lightweight shortcode-based
  embedding.
• Issuu integration
  provides older API, upload, field, and media integrations. Issuu Embed
  Filter focuses only on embedding existing publications in Drupal 10 and
  Drupal 11 content.