Skip to Content

Core Concepts

Data apps

Package dashboards and metrics for one product, and decide where your customers see them.

What is a data app?

A data app is the container your embeds live in. It holds the dashboards and metrics you share, the API tokens your backend uses, the sites the embeds may load on, and the theme. Its type decides where the embeds are delivered: inside your product, in Slack or in Microsoft Teams.

Make one data app per product or customer portal, for example Customer portal.

Data app Overview with the Go-live readiness checklist (API token, embed, allowed domain, demo branding, theme) and the Installation card
A data app's Overview: what is ready to go live, and the two install steps for your developers.

Types of data app

TypeWhere customers see itPlan
EmbeddedInside your product, with the <dbn-dashboard> or <dbn-metric> web componentEnterprise, or a trial
SlackIn Slack, where your team can ask Databrain questionsEvery plan
Microsoft TeamsIn Microsoft TeamsEvery plan

What’s inside a data app

An Embedded data app has these tabs:

TabWhat it holds
OverviewThe Go-live readiness checklist and the install steps
TenancyChecks that each client sees only their own rows
EmbedsThe dashboards and metrics this app can show, with Get snippet for each
API tokensThe keys your backend uses to create guest tokens. A key is shown once
DomainsThe sites your embeds may load on. Every data app in your company uses this list
Demo brandingThe title and logo for your demo page
ThemeThe look of embeds that have no theme of their own
ReportsScheduled reports

Draft and Live

A new data app is Draft. It turns Live as soon as it has at least one embed. Live does not mean customers can see it yet: your backend still needs an API token and your page needs the snippet. See Embedding architecture.

Create a data app

Before you start, you must be an Admin or a Developer, or have the data app Create permission. You also need a workspace with a dashboard.

  1. Go to Data Studio > Data Apps and select Create data app.
  2. Enter an App name, for example Customer portal.
  3. Select the Data app type and the Workspace.
  4. Select Create data app.
New data app dialog with App name Partner analytics, Data app type Embedded, Workspace Marketing Analytics, and Create data app button
The New data app dialog. The type decides where the embeds are delivered.

An Embedded app opens on its Overview. Slack and Teams apps open their setup page.

Add an embed

An embed binds one dashboard, or one metric from it, to the data app.

  1. Open the data app and select the Embeds tab.
  2. Select Add embed.
  3. Select the Workspace, the Embed type (Dashboard or Metric) and the Dashboard.
  4. Select Create embed.
New embed dialog with Workspace, Embed type, Dashboard and Description fields and the Create embed button
The New embed dialog. Pick Dashboard to embed the whole dashboard, or Metric to embed one card.

You see Embed created. Select Get embed code to copy the snippet into your app.

If something goes wrong

  • Embedded data apps are available on Enterprise. Your plan does not include embedding. Slack and Teams data apps still work.
  • Another data app already has this name. Pick a different name.
  • This workspace has no dashboards. Create a dashboard first.

Next steps