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

# Report Dimensions

> Slice your data by custom dimensions

Dimensions let you break down reports by different attributes. Analyze performance by creative, offer, geography, and more.

## Built-In Dimensions

| Dimension          | Description                                            |
| ------------------ | ------------------------------------------------------ |
| Date               | Daily breakdown                                        |
| Week               | Weekly breakdown                                       |
| Month              | Monthly breakdown                                      |
| Creative           | By message template                                    |
| Offer              | By affiliate offer                                     |
| Sending List       | By phone number                                        |
| Campaign           | By schedule                                            |
| Schedule Send Type | Type of scheduled send                                 |
| Is Local Time      | Whether send used local time zone                      |
| Message Send Type  | How the message was triggered (API, schedule, journey) |
| Selection Method   | Creative selection method (manual, algorithmic)        |
| Offer Type         | Category of affiliate offer                            |
| Carrier            | Recipient mobile carrier                               |
| Delivery Success   | Whether message was delivered successfully             |
| Error Reason       | Reason for delivery failure                            |
| Segment IDs        | Audience segments the contact belongs to               |

## Custom Dimensions

Create dimensions from contact custom fields:

### Setting Up

1. Go to **Account Settings > Reporting**
2. Click **Add Dimension**
3. Select a custom field
4. Name the dimension
5. Save

### Example: State

If contacts have a `state` field:

1. Add dimension: "State"
2. Field: `state`
3. Reports can now break down by state

### Cardinality

Dimensions work best with:

* Low cardinality (few unique values)
* Meaningful groupings
* Complete data

Examples:

* ✅ State (50 values)
* ✅ Plan type (3 values)
* ❌ Email (too many unique values)

## Using Dimensions in Reports

### Performance Report

1. Go to **Reports > Performance**
2. Select dimension from dropdown
3. View metrics broken down

### Example Output

**By State:**

```
California: 10,000 sends, 12% click rate, $2,400 revenue
Texas: 8,000 sends, 11% click rate, $1,760 revenue
Florida: 6,000 sends, 13% click rate, $1,560 revenue
```

## Dimension Coverage

Not all contacts may have data for a dimension:

```
State dimension:
- Has value: 85%
- Missing: 15%
```

Missing values appear as "(not set)" in reports.

### Improving Coverage

* Require field at signup
* Enrich data from external sources
* Default values for common cases

## Multi-Dimensional Analysis

Combine dimensions for deeper analysis:

```
Date + Creative:
Shows how each creative performed each day
```

Note: More dimensions = more rows = slower reports.

## Dimension Refresh

Custom dimension stats are calculated periodically:

* Coverage percentage
* Unique value count
* Last updated timestamp

Click **Refresh** to recalculate.

## Best Practices

<AccordionGroup>
  <Accordion title="Start with built-in dimensions">
    Date, Creative, Offer cover most needs. Add custom only when needed.
  </Accordion>

  <Accordion title="Keep cardinality low">
    Dimensions with 50+ values become hard to analyze. Group values if needed.
  </Accordion>

  <Accordion title="Ensure data quality">
    Dimensions are only as useful as the underlying data. Validate custom fields.
  </Accordion>
</AccordionGroup>

## Next Steps

<CardGroup cols={2}>
  <Card title="Metrics" icon="chart-bar" href="/guides/reporting/metrics">
    Available metrics
  </Card>

  <Card title="Exports" icon="download" href="/guides/reporting/exports">
    Export data
  </Card>
</CardGroup>