# Using a Data Table

#### Step 1: Add a Data Table

In Edit Mode, click the **Add** button in the top-right corner. From the dropdown menu, select **Data Table**.

<figure><img src="https://2842104411-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHpyGcySly0ioPMFyq3FR%2Fuploads%2Fyze6kss9fa9sZkHDwnqK%2FScreenshot%202026-03-24%20at%209.46.25%E2%80%AFam.png?alt=media&#x26;token=c91bca5b-bc02-464c-adfa-60e50fe6ebde" alt=""><figcaption></figcaption></figure>

#### Step 2: Configure the Table

In the **Create Data Table** panel, give your table a name and set the number of rows and columns you need. Then click **Create Table**.

<figure><img src="https://2842104411-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHpyGcySly0ioPMFyq3FR%2Fuploads%2FTdwcprHiHXPM1uLm2b4g%2FScreenshot%202026-03-24%20at%209.46.36%E2%80%AFam.png?alt=media&#x26;token=fae02a64-1ea9-49be-b1b0-75535fa89a6b" alt=""><figcaption></figcaption></figure>

#### Step 3: Enter data or select a cell to link

Your new empty table will appear on the dashboard. You can type static values directly into any cell, or select a cell to link it to a live data source.

<figure><img src="https://2842104411-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHpyGcySly0ioPMFyq3FR%2Fuploads%2FrYTjRgugwV1l3jc2SL93%2FScreenshot%202026-03-24%20at%209.48.26%E2%80%AFam.png?alt=media&#x26;token=9fbb94a4-8244-4701-aa5d-975563f04673" alt=""><figcaption></figcaption></figure>

To link a cell to live data, click the cell you want to populate (e.g. **B3**) and then click the **link icon** in the cell toolbar.

<figure><img src="https://2842104411-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHpyGcySly0ioPMFyq3FR%2Fuploads%2F4jGHqVCFhGcJaGEBEOAo%2FScreenshot%202026-03-24%20at%209.59.49%E2%80%AFam.png?alt=media&#x26;token=55906e6f-6340-4bf6-81b8-032dabecb3cf" alt=""><figcaption></figcaption></figure>

#### Step 4: Configure the Custom Block

The **Create Custom Block** panel will open on the right. Here you can:

* Choose your **Data Source Type** (e.g. Google Analytics 4)
* Give the custom block a **name** — this becomes a project datablock
* Select your **Database Connection**

Then click **Configure** to set up the query.

<figure><img src="https://2842104411-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHpyGcySly0ioPMFyq3FR%2Fuploads%2FWiQoHgsDkiDvjU9eDHy1%2FScreenshot%202026-03-24%20at%209.49.26%E2%80%AFam.png?alt=media&#x26;token=18e9fd21-157b-414e-ad6c-9eb2854b343a" alt=""><figcaption></figcaption></figure>

#### Step 5: Set Metrics, Dimensions & Filters

Under the **Configuration** section, set your desired **Date Range**, then scroll down to choose your **Metrics** (e.g. Active Users) and optionally add **Dimensions**, **Metric Filters**, **Dimension Filters**, and **Order By** settings.

<figure><img src="https://2842104411-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHpyGcySly0ioPMFyq3FR%2Fuploads%2FsUFRXgHYn9kpHFhvrYrP%2FScreenshot%202026-03-24%20at%209.49.37%E2%80%AFam.png?alt=media&#x26;token=7fbeab66-c55c-4e00-a3af-241710cae508" alt=""><figcaption></figcaption></figure>

When ready, click **Preview Data**.

#### Step 6: Preview and select your primary metric

After previewing, you'll see a **Data Preview** showing the results. Choose how to aggregate the data — either **Total** (sum all numeric values) or **Average** — then select the **primary metric** to display in the cell from the dropdown.

Click **Create Custom Block** to confirm.

<figure><img src="https://2842104411-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHpyGcySly0ioPMFyq3FR%2Fuploads%2FxOCdnfLW0qenmce4E7ph%2FScreenshot%202026-03-24%20at%209.49.51%E2%80%AFam.png?alt=media&#x26;token=812c2b5c-bf17-4b6b-b8bd-7aeec949347c" alt=""><figcaption></figcaption></figure>

#### Step 7: Save your dashboard

Your cell will now display live data pulled from your connected data source. The status bar at the bottom of the table will show **Ready** and indicate which datablock the cell is linked to. Click **Save** in the top-right to save your changes.

<figure><img src="https://2842104411-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHpyGcySly0ioPMFyq3FR%2Fuploads%2F4pnfOTg0BUprVm3HBHmY%2FScreenshot%202026-03-24%20at%209.50.11%E2%80%AFam.png?alt=media&#x26;token=bf528f2b-79f6-4377-8d5a-51ece45ea247" alt=""><figcaption></figcaption></figure>
