> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lightdash.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Set up and manage live data sources

> Connect, query and manage a live data source

Live data sources must be [enabled for your organization](https://docs.lightdash.com/integrations/live-data-sources). These steps are the same for every integration; each integration's page has its own sign-in details, dimensions, metrics and limits.

## Connect a live data source

Project admins can add live data sources. You also need access to the tool itself; each integration page lists what it needs.

1. On the nav bar, click **Browse** → **Semantic Layer**.
2. In the sidebar, select **Live data sources**, then click **Add**.
3. In the **Add a live data source** dialog, select an integration, then follow the steps on its integration page.

![The Add a live data source dialog listing the integrations you can connect, and others with a Request button](https://mintcdn.com/lightdash/bfRhm6Fu1UC-QFZJ/images/integrations/live-data-sources/add-live-data-source.png?fit=max\&auto=format\&n=bfRhm6Fu1UC-QFZJ\&q=85\&s=aef04ee3fed15f4b5d7ec7470f06af67)

When the source is added, Lightdash reads its dimensions and metrics, and the source appears under **Live data sources** and as a table in Explore with a **Live** badge.

![The Semantic Layer page with Live data sources selected, listing connected sources with their data read, API calls and median latency](https://mintcdn.com/lightdash/bfRhm6Fu1UC-QFZJ/images/integrations/live-data-sources/live-data-sources-list.png?fit=max\&auto=format\&n=bfRhm6Fu1UC-QFZJ\&q=85\&s=facbee618a36127d180c2c1b886d0ce3)

You can connect several sources from the same integration, such as one for each account. Give each a clear name, because people and agents use the name to choose a source.

## Dimensions and metrics

Each source starts with the dimensions and metrics its integration offers, plus the ones Lightdash reads from your account, such as custom properties or events. Each integration page lists them. Select a source under **Live data sources** to see them. Only dimensions and metrics marked **In use** appear in Explore and to AI agents.

![A live data source's page with its integration, access, usage and a searchable list of dimensions with their descriptions](https://mintcdn.com/lightdash/bfRhm6Fu1UC-QFZJ/images/integrations/live-data-sources/live-source-fields.png?fit=max\&auto=format\&n=bfRhm6Fu1UC-QFZJ\&q=85\&s=6366b71c78c68da0af3061a16afc7aef)

Click a dimension or metric to change its **Label**, **Description**, **AI hint** and **Group**, or turn **In use** off. Click **Save** to apply. Click **Refresh fields** to read them from the integration again after you add properties or events in the tool. You can't add dimensions or metrics of your own, or manage them as code.

![The Country dimension dialog with Label, Description, AI hint, Group and an In use toggle, and its type, source name, charts that use it and last change below](https://mintcdn.com/lightdash/bfRhm6Fu1UC-QFZJ/images/integrations/live-data-sources/live-source-field-details.png?fit=max\&auto=format\&n=bfRhm6Fu1UC-QFZJ\&q=85\&s=6c210d055e585aadadcb5493b925a254)

## Explore a live data source

In Explore, open the source's table, which has a **Live** badge. Pick metrics and dimensions, and run the query. Each run is one call to the integration.

![Explore on a live data source with a Live badge, showing a bar chart and results of a metric split by a dimension](https://mintcdn.com/lightdash/bfRhm6Fu1UC-QFZJ/images/integrations/live-data-sources/live-source-explore.png?fit=max\&auto=format\&n=bfRhm6Fu1UC-QFZJ\&q=85\&s=d0056b2b3c5357783188a0085ea08706)

Save the result as a chart to add it to a dashboard or a scheduled delivery.

## Ask an AI agent about a live data source

Every agent in the project can query live data sources, whatever tags it's limited to. Ask in plain language; the agent picks the dimensions and metrics, adds a date filter for the period you mention and builds a chart. Name the tool in your question when the project has more than one source that could answer it.

![An AI agent thread answering a question from a live data source with a summary, a results table and a bar chart](https://mintcdn.com/lightdash/bfRhm6Fu1UC-QFZJ/images/integrations/live-data-sources/live-source-agent-answer.png?fit=max\&auto=format\&n=bfRhm6Fu1UC-QFZJ\&q=85\&s=1d1ff9c3495e914221cb2f99cc56a76c)

If a question needs something a source can't do, such as a funnel, the agent says so instead of approximating it.

## Manage a live data source

Open a source's menu from the **Live data sources** list or its page. **Edit** renames it, **Refresh fields** reads its dimensions and metrics again, **Sign in again** reconnects it with your account, and **Delete** removes it and its table.

![The Live data sources list with the actions menu open on a source, showing Edit, Refresh fields, Sign in again and Delete](https://mintcdn.com/lightdash/bfRhm6Fu1UC-QFZJ/images/integrations/live-data-sources/live-source-actions.png?fit=max\&auto=format\&n=bfRhm6Fu1UC-QFZJ\&q=85\&s=4a3786c952c9fed6eb3ef43c250a8325)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.