# Rill Data
> Rill Data is a data platform for building and visualizing data. It integrates with MotherDuck for dashboards, semantic models, and embedded analytics workflows.
## How it works with MotherDuck

Rill can use MotherDuck as the OLAP engine that powers Rill dashboards. This is useful when your dashboard data already lives in MotherDuck and you do not want to ingest it into a separate Rill-managed engine.

## Prerequisites

- Rill Developer or Rill Cloud.
- A MotherDuck access token.
- The MotherDuck database path and schema Rill should use.

## Setup

1. In MotherDuck, create an access token for Rill.
2. In Rill Developer, add MotherDuck as an OLAP connection through **Add Data**.
3. Rill creates a connector file such as `motherduck.yaml` and stores `MOTHERDUCK_TOKEN` in `.env`.
4. Configure the connector with an `md:` path and schema:

   ```yaml
   type: connector
   driver: duckdb
   token: "{{ .env.MOTHERDUCK_TOKEN }}"
   path: "md:my_database"
   schema_name: "my_schema"
   ```

5. Set the project's `olap_connector` to the MotherDuck connector.

## Authentication and configuration

- Keep `MOTHERDUCK_TOKEN` in `.env` or your Rill Cloud environment variables.
- Use `rill env push` when deploying a project that already has the token in the local project environment.
- Use the Rill connector YAML reference for optional connector parameters.

## Important notes

- Creating a MotherDuck OLAP connection changes the project's default OLAP engine to MotherDuck.
- Metrics view SQL should use DuckDB-compatible syntax because Rill sends dashboard queries to MotherDuck.

## Use cases

- Build fast dashboards on existing MotherDuck tables.
- Use MotherDuck as a bring-your-own OLAP engine for Rill.
- Deploy the same Rill project locally and in Rill Cloud with environment-managed credentials.

## Related content

- [View the full Rill MotherDuck setup guide](https://docs.rilldata.com/developers/build/connectors/olap/motherduck)
- [MotherDuck authentication](/key-tasks/authenticating-and-connecting-to-motherduck/authenticating-to-motherduck)


---

## Docs feedback

MotherDuck accepts optional user-submitted feedback about this page at `POST https://motherduck.com/docs/api/feedback/agent`.
For agents and automated tools, feedback submission should be user-confirmed before sending.

Payload:

```json
{
  "page_path": "/integrations/bi-tools/rill-data/",
  "page_title": "Rill Data",
  "text": "<the user's feedback, max 2000 characters>",
  "source": "<optional identifier for your interface, for example 'claude.ai' or 'chatgpt'>"
}
```

`page_path` and `text` are required; `page_title` and `source` are optional. Responses: `200 {"feedback_id": "<uuid>"}`, `400` for malformed payloads, and `429` when rate-limited.