Celiq
v0.12Open app โ†—
Docs/Tutorials/Create Topics

Create Topics

Group related metrics and dimensions into a governed Topic so Orion and your team navigate the semantic model by business area

WeaverLuminaryUpdated June 2026 ยท 6 min read
โœฆ
In this section
Part of Celiq's semantic layer platform. Connect your warehouse, model your data once, query it everywhere.
๐Ÿ’ก
Tip
Goal: Bundle the metrics and dimensions for one business area into a Topic so Orion reaches for trusted, grouped context.
Time: About 10 minutes.
You'll need: Some metrics and dimensions already modeled, plus a clear business area to group.
Role: Weaver or Luminary (only Luminaries can certify).

A Topic is a curated bundle of related semantic objects that gives Orion grouped context for one business area โ€” for example "Revenue Analysis" or "Customer Retention". In this tutorial you'll create a Topic, add the objects that belong in it, and certify it so the whole organization can rely on it.

Semantic layer object map
Semantic layer object map

Before you start

  • You have a Weaver or Luminary role. Both can create and edit Topics; only Luminaries can certify.
  • You already have some semantic objects modeled โ€” metrics and dimensions โ€” so you have things to bundle. See Metrics and Dimensions.
  • You know which business area you're grouping and the questions it should answer. Background: Topics.

Steps

1

Open Topics in Context Studio

Go to Context Studio, then in the left nav choose Topics (the tag icon). You'll see the list of existing Topics, each with its status badge and item count.

2

Start a new Topic

Click + New topic. An inline form opens.

3

Name the Topic

Enter a clear Topic name, for example Revenue Analysis. The name is required โ€” you cannot save without one.

4

Describe what it answers

In the Description field, write what questions this Topic helps answer. It's optional but strongly recommended โ€” it's the context Orion and your teammates read to understand the Topic's purpose.

5

Create the Topic

Click Create topic. The new Topic appears at the top of the list with a draft status badge.

6

Add items

Add the semantic objects that belong in this Topic. Each item points at one object by its type and id, and is given a role. Mark the central metric with the role primary; if you don't set a role, the item is saved as supporting.

7

Certify when ready (Luminary only)

Once the Topic is reviewed and trusted, a Luminary clicks Certify. The status changes to certified, the card border turns green, and Celiq records who certified it and when.

Result

Your Topic appears in the Topics list with an accurate item count, and Orion treats the bundle as a coherent group when answering questions about that business area. Once a Luminary has certified it, the Topic shows a green certified badge โ€” the signal that the organization can trust it.

๐Ÿ“
Note

Use the item count badge as a quick health check. A certified Topic with zero items means the bundle was never populated โ€” open it and add the objects it should group.

Next steps