Dashboard tiles: an optional subtitle line under the tile title

Open
#32,815 1 comment 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
4/5
Estimated time
3-5 days
Newbie friendliness
55/100
Issue type
Feature
Clarity
Mostly clear
Activity status
Active
Tech stack
typescript
Domain
frontend

Research direction

Start with DashboardChartTileProperties and DashboardSqlChartTileProperties in packages/common/src/types/dashboard.ts, then read packages/frontend/src/components/DashboardTiles/TileBase/index.tsx to follow how tile titles and descriptions render. Check how saved chart and SQL chart configuration types are used, since the issue notes they have no subtitle option. Done means both tile kinds can set a subtitle in the dashboard editor and dashboards as code, and it appears under the title unless hideTitle is set.

Written by the indexing model from the issue text.

Description

Description

Add an optional subtitle to chart and SQL-chart dashboard tiles: one short line under the tile title, always visible, set per tile in the dashboard editor and in dashboards as code. This is narrower than #18099, which asked for a subtitle on the chart itself and was closed as not planned. A tile already has its own title and hideTitle, so a subtitle would sit beside them and work for every chart kind.

What problem does this solve?

Each tile on a dashboard needs its unit and period in view, for example "AUD, FY27 month ends". Today that text can go in two places:

  • The tile title, which makes titles long and mixes what is measured with its unit.
  • The chart description, which shows only when a viewer hovers over the tile title. Viewers who don't hover miss it.

Where in the code (main, 18 Nov 2026):

  • packages/common/src/types/dashboard.ts: DashboardChartTileProperties and DashboardSqlChartTileProperties have title and hideTitle, and no subtitle.
  • packages/frontend/src/components/DashboardTiles/TileBase/index.tsx: the chart description is shown inside a Tooltip around the tile title, so only on hover.
  • Neither packages/common/src/types/savedCharts.ts nor the SQL chart config types in packages/common/src/visualizations/types/index.ts have a subtitle option.

Our workaround only works for custom (Vega-Lite) charts: we put the line in the spec's title.text and style it as a subtitle (anchor: start, fontSize: 11, fontWeight: normal, a grey colour). Standard and SQL chart tiles have no way to show it.

Suggested shape: subtitle?: string on chart and SQL-chart tile properties, shown in smaller grey text under the title, hidden with the title when hideTitle is set.

Dominant language
TypeScript
Stars
6.2k
Forks
809
Avg merge
12h 13m
Merged PRs (30d)
854

Getting set up

This project ships no dev container, Dockerfile or contributing guide, so setting up is up to you: start from its README, and see our first-contribution guide for the general steps.

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from lightdash/lightdash

All issues in lightdash/lightdash

Similar issues

More TypeScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.