Custom Metadata Field as Dimension in Dashboard Widgets

[tjs-coding]

Hi!

I am trying to create a widget for a custom dashboard.
The documentation states you can use custom metadata as a dimension but I do not see this option when creating a widget?

[dosubot[bot]]

Hi @tjs-coding! I'm Dosu and I’m helping the langfuse team.

The documentation does say you can use custom metadata as a dimension in widgets, but currently, the frontend only exposes a fixed set of fields as dimension options for each widget type—custom metadata fields are not dynamically listed or selectable. This isn't controlled by a feature flag or permission; it's just not implemented yet in the UI or backend to enumerate arbitrary metadata fields as dimensions [docs].

As a workaround, if you want to group or filter by custom metadata, make sure you attach it directly to the trace (not just observations or experiment runs). For example, you can write your metadata into a trace-level tag or metadata key, which are supported as dimensions and filters [discussion].

If you need this feature, it would require product changes to support dynamic metadata fields as dimensions in the widget configuration. If you’re on a much older or customized deployment, let me know your version—otherwise, this is a current product limitation.

To reply, just mention @dosu.

---

^{How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other}   

[marcklingen]

I’m very sorry. This is a roadmap item that made it to the docs too early (initially this was part of the scope and then we cut it as there was some complexity in using metadata at scale in dashboards). Will update the docs right now.

[aesher9o1]

@maxdeichmann any idea if we'll pick this up for the next release?

[maxdeichmann]

Hi, yes we are currently migrating to a new data model under the hood which will allow for this feature.

[a0919376604]

any update?

[maxdeichmann]

Hi, there is no update to this. The team works full steam ahead to work on a new data model which will also enable this feature going forward. We do not have a timeline here to share publicly.

[aparim05]

+1, I’d really love this as well. Our team would use custom metadata as dashboard dimensions heavily. So having this supported in widgets would be super helpful.