Celiq
v0.12Open app โ†—
Docs/Getting Started/What is Celiq

What is Celiq

A conceptual tour of Celiq โ€” a self-hosted semantic analytics platform where you model once, explore without SQL, and ask Orion in plain English.

LuminaryWeaverTracerLensUpdated 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
What it is โ€” Celiq is a self-hosted semantic analytics platform: you model your data once, then everyone explores it without writing SQL.
When to use it โ€” Read this first, before any other page, to understand how the pieces fit together.
Where to find it โ€” This is the front door. Once you sign in, the product opens on Discover (the eye icon in the bottom navigation pill).
Who can use it โ€” Everyone: Luminary, Weaver, Tracer, and Lens. What each role can do differs, and that is covered below.

Celiq connects to your data warehouse, lets a builder describe what the data means once, and then lets everyone else ask questions of it โ€” by clicking, or in plain English โ€” without touching SQL. This page is the conceptual map. It explains the core flow and the four hubs you see in the navigation, then points you to the pages that cover each piece in depth.

Overview

What is Celiq in Celiq
What is Celiq in Celiq

Celiq sits on top of the warehouse you already have. It does not move or copy your data โ€” it queries it live. The value Celiq adds is a semantic layer: a shared, version-controlled definition of what every table, field, and metric means. Once that layer exists, three things become true at once:

  • Analysts stop writing SQL. They pick fields and filters; Celiq generates and runs the query.
  • Numbers stop diverging. When a metric is defined once, everyone who uses it gets the same answer.
  • AI can be trusted. Because Orion reads the same governed semantic layer humans do, its answers are grounded in your definitions rather than guessed from raw column names.

Everything in the product flows in one direction:

Data warehouse  โ†’  Forge (semantic model in CML)  โ†’  Discover (Reveal, no SQL)  โ†’  Prism / Mosaic  โ†’  Vault

Your raw tables live in the warehouse. Forge is where a builder defines what those tables mean, in CML. Discover is where anyone queries that model without SQL โ€” each live query session is a Reveal. You save a Reveal as a Prism, or pin it to a Mosaic (a dashboard). Both live inside a Vault, which controls who can see them. Orion, the AI layer, reads the same semantic model and answers questions in plain language across that whole flow.

When to use it

Read this page when you are new to Celiq and want the big picture before diving in. It is intentionally conceptual โ€” it tells you what the pieces are and how they connect, not the mechanics of using each one. For hands-on detail, follow the links throughout and in Related pages.

You do not need to read this page to get value if someone has already built a Mosaic for you โ€” you can open it and read it. But understanding this flow makes everything else in the product click into place.

Concepts

These are the core ideas. Each one has a dedicated page; the Key concepts page covers the mechanics in depth. Here is just enough to orient you.

TermWhat it is
WarehouseYour existing database (Postgres, BigQuery, Snowflake, or DuckDB). Celiq queries it live; it never holds a second copy of your data.
Semantic modelThe governed definition of what your data means โ€” names, dimensions, metrics, and security rules. The single source of truth.
CMLCeliq Modelling Language โ€” the YAML-based syntax you write the semantic model in, inside Forge.
ForgeThe place builders define and edit the semantic model.
DiscoverThe no-SQL query builder everyone uses to explore the model.
RevealA single live query session in Discover. It re-runs against the warehouse every time you change it.
PrismA saved Reveal โ€” the question is fixed, the answer refreshes against current data.
MosaicA dashboard: a collection of tiles, each backed by a Prism or Reveal.
VaultA folder that holds Prisms and Mosaics and controls who can view or edit them.
OrionThe AI layer that understands the semantic model and answers natural-language questions.
๐Ÿ“
Note

Celiq separates a Reveal (a live, unsaved session) from a Prism (a saved result) on purpose. The question you save stays fixed; the answer updates every time the Prism is opened. This makes sharing and scheduling predictable.

The four hubs

The bottom navigation pill groups the product into a few hubs. Three of them are pickers that open a menu; the rest navigate directly. What you see depends on your role.

HubIconWhat lives hereWho sees it
DiscoverEyeThe no-SQL query builder โ€” where you build Reveals.Everyone
FolioTemplateThe reporting hub: Mosaics, WBR, and Workbooks.Everyone
LoomNeedle & threadThe build hub: Projects, Forge, Studio, and Context Studio.Weaver and Luminary
SuiteGridThe full sitemap โ€” every other page, grouped into Explore, Operate, AI, and Govern.Everyone (items filtered by role)

Alongside these, Vaults (where saved work lives), Lumen (admin), and Trash appear in the pill for the roles that can use them. Lumen and Trash are Luminary-only.

The takeaway: Discover is where you ask, Folio is where you present, Loom is where builders model, and Suite is the directory to everything else.

The four roles

Every person in a workspace has exactly one role. The role decides what they can do โ€” not just what they can see.

RoleIn one lineCan build the model?Can run Reveals?Can administer?
LuminaryAdministratorYesYesYes
WeaverBuilderYesYesNo
TracerAnalystNoYesNo
LensViewerNoNo (views shared work)No

A Lens can open Mosaics and Prisms shared with them. A Tracer can run their own Reveals in Discover and save Prisms. A Weaver can additionally edit the semantic model in Forge. A Luminary can do everything, including managing users and security. See User roles for the full breakdown.

Getting started

You do not need to set anything up to read this page. To start using Celiq:

1

Sign in

Open your workspace URL and sign in. Celiq opens on Discover by default.

2

Find the navigation pill

Look at the floating pill at the bottom-centre of the screen. This is how you move between hubs. It hides as you scroll down and reappears as you scroll up.

3

Confirm a warehouse is connected

If a builder has already connected a warehouse and modelled data, Discover will offer nodes you can explore. If it is empty, a Luminary or Weaver needs to connect a warehouse first โ€” see Connecting a warehouse.

4

Read the mechanics next

Move on to Key concepts for how Reveals, Prisms, Mosaics, and Vaults actually work, then try the Quick start.

Examples

Here is the same business question answered three ways, to show how the layers connect.

A Weaver defines the metric once in CML, inside Forge:

orders.yml
measure:

- name: total_revenue

label: Total Revenue

type: sum

sql: ${revenue}

format: usd

A Tracer then answers "revenue by month" in Discover with no SQL โ€” they pick the Total Revenue measure, group by order date at month granularity, and Celiq runs the query live. They save the result as a Prism and pin it to a team Mosaic.

A Lens who cannot build anything simply asks Orion in plain English:

What was total revenue by month this year?

Because Orion reads the same total_revenue definition, all three paths return the identical number โ€” there is no second definition of "revenue" anywhere. That single-definition guarantee is the whole point of the semantic layer.

Best practices

  • Model once, in Forge. Resist defining the same metric in two places. One CML definition keeps every Reveal, Mosaic, and Orion answer consistent.
  • Save questions, not screenshots. Prefer a Prism or Mosaic over exporting a static image โ€” saved work refreshes against live data.
  • Organise with Vaults early. Decide what is personal, what is team-shared, and what is workspace-wide before content piles up.
  • Let the right role do the right job. Builders shape the model in Loom; analysts explore in Discover; everyone can ask Orion.

Tips

๐Ÿ’ก
Tip

The fastest way to learn Celiq is to ask Orion a question you already know the answer to. Seeing how it reads the semantic model โ€” and which fields it picks โ€” teaches you the model's shape quickly, and builds trust in its answers.

Common mistakes

โš ๏ธ
Warning
  • Treating Discover like a SQL editor. Discover is a no-SQL query builder. If you find yourself wanting raw SQL, the metric you need probably belongs in the semantic model in Forge.
  • Confusing a Reveal with a Prism. A Reveal is a live, unsaved session โ€” close the tab and it is gone. A Prism is the saved version. Save before you navigate away.
  • Expecting to see every hub. Loom, Lumen, and Trash are role-gated. If you do not see them, your role does not include them โ€” that is by design, not a bug.
  • Looking for "Scenes." Saved Reveals are called Prisms. "Scenes" is an older name you may still hear; the product uses Prisms.

Troubleshooting

SymptomLikely causeWhat to do
Discover has nothing to exploreNo warehouse connected, or no semantic model built yetA Luminary or Weaver needs to connect a warehouse and model data in Forge
You cannot see the Loom hubYour role is Tracer or LensLoom is for Weaver and Luminary; ask a Luminary if you need build access
You cannot see Lumen or TrashThese are Luminary-onlyAsk a Luminary to make the change you need
Orion's number differs from a colleague'sA metric may be defined in two places, or you are filtered differentlyCheck the metric in Forge; confirm the same definition backs both
A saved view is empty for one person but not anotherVault access or row-level security differs by userCheck the Vault's access and any Data Keys with a Luminary
  • Key concepts โ€” the mechanics of nodes, Reveals, Prisms, Mosaics, and Vaults
  • Getting started โ€” the section landing page and where to go next
  • Quick start โ€” build your first Reveal end to end
  • Orion โ€” how the AI layer reads the semantic model
  • User roles โ€” what each role can and cannot do
  • Navigation โ€” the hubs and the bottom nav pill in detail