Metabase Integration

Project summary

Embeds Metabase dashboards in Drupal using a configurable block with secure, token-based authentication.

Introduction

This module provides a simple and secure way to embed Metabase dashboards directly into Drupal sites. It adds a custom block type that allows site builders to display Metabase dashboards within Drupal regions without custom theming or manual iframe configuration.

Authentication and access control are handled using Metabase’s signed embedding mechanism, ensuring that dashboard access and sensitive data remain protected.

The module is lightweight, configuration-driven, and suitable for both internal analytics dashboards and user-facing reporting interfaces.

Features

• Adds a Metabase Dashboard block type
• Secure dashboard embedding using signed tokens
• No hardcoded credentials in configuration
• Easy placement using Drupal’s block layout system
• Compatible with Drupal 10 and Drupal 11
• No server-side performance impact

Requirements

• Drupal 10 or Drupal 11
• A running Metabase instance with embedding enabled
• A Metabase secret key configured in Drupal settings

There are no additional module dependencies.

Installation

Install the module as you would any contributed Drupal module.

For general installation instructions, see: https://www.drupal.org/node/895232

Configuration

1. Add the following values to your settings.php file:

   $settings['metabase.site_url'] = 'https://metabase.example.com';
   $settings['metabase.secret_key'] = 'your-secret-key';

2. Go to Administration → Structure → Block layout.
3. Add a new block of type Metabase Dashboard to the desired region.
4. Configure the block with the appropriate dashboard settings and save.

Use cases

• Internal analytics dashboards
• Business intelligence reporting
• Administrative or editorial metrics
• Secure, role-based dashboard display