Interactive embedding

BETA FEATURE

This is a Beta feature. The documentation and feature may change rapidly. You can request Beta access and try it out.

Introduction

Interactive embedding goes beyond just displaying static dashboards in your app. It lets your users actively explore data, drill down into details, and discover insights on their own - just like they would in a full analytics platform.

Why enable interactive features?

For your users:

• They can answer follow-up questions without leaving your app
• They get deeper insights by exploring data themselves
• They can customize views to match their specific needs

For your business:

• Reduced support requests for "Can you show me..." questions
• Higher user engagement with your analytics
• Users become more self-sufficient with data

How to set up interactive features

info

What interactive features are available?

• Drill through
• Data exploration, view underlying data, and drill down
• Create and manage dashboards

Drill through

Drill through lets users navigate between related dashboards to explore data in more detail.

Step 1: Configure drill through in Holistics

Before your embedded users can drill through data, you need to set up the drill paths in your Holistics workspace.

What this means: Define which dashboard connects to which (e.g., "Sales Overview" drills to "Product Details")

Need help? Check our drill through setup guide for detailed instructions.

Step 2: Include all connected dashboards

Add every dashboard in your drill-through chain to the embed portal.

Why: Users can only drill through to dashboards that are available in their embed portal

your_embed_portal.embed.aml

EmbedPortal ecommerce_portal {
  objects: [
    sales_overview_dashboard,     // Starting point
    product_details_dashboard,    // Drill target
    customer_analysis_dashboard   // Another drill target
  ],
}

Real-world example:

• Main dashboard: "Company Sales Overview"
• Drill targets: "Regional Sales Details", "Product Performance", "Customer Segments"
• Result: Users can start with the overview and drill into any specific area

Step 3: Deploy your setup

1. Publish your embed portal in Holistics
2. Integrate it into your application using the embed code

Data exploration, view underlying data, and drill down

These three features all share the same setup: include the underlying datasets of the visualizations you want to enable in your embed portal.

your_embed_portal.embed.aml

EmbedPortal ecommerce_portal {
  objects: [
    sales_dashboard,        // The dashboard users will see
    sales_dataset,          // Underlying dataset used by the dashboard
  ],
}

Once the datasets are included, your users get access to the following features:

Data exploration

Data exploration lets users modify and interact with individual charts and visualizations — change visualization types, add or modify filters, group data differently, and adjust time ranges. For more details, see our data exploration guide.

View underlying data

View underlying data lets your users click on any data point and instantly see the detailed records behind it. Instead of just seeing a number, they can explore "what makes up this value" at the row level. For more details, see our view underlying data guide.

Drill down & break down

Drill down and break down give your users instant analytical depth without leaving the embedded dashboard. They can split any metric by different dimensions (break down) or click a specific data point to filter and break it down further (drill down). For more details, see our drill down & break down guide.

Save functionality

If you want users to save their custom explorations, they need a workspace to save them to.

What you need

Users must have either:

• Personal workspace access (for private saves)
• Shared workspace access (for team collaboration)

How to enable it

This is configured in your embed portal permissions:

const embed_payload = {
  "embed_user_id": "user_1_id",
  "embed_org_id": "department_1",
  
  "permissions": {
    // Enable personal workspace for private saves
    "enable_personal_workspace": true,
    
    // OR enable shared workspace for team saves
    "org_workspace_role": "editor" // or "viewer"
  }
}

Need workspace setup help? Check our identity and workspace settings guide.