# Troubleshooting dashboards

If a dashboard doesn't behave as you expect, find the symptom below. Each fix says who can make it:

- **You**: anyone viewing the dashboard
- **Editor**: someone who can edit the dashboard
- **Admin**: someone with access to [**Application Settings**](<https://help.apteco.com/en/orbit/reference/admin/application-settings/index.md>)

## A filter doesn't change a tile

Several filters can apply to a tile at once, and some take priority over others. If a filter doesn't change a tile, work through these checks in order:

1. **See what reaches the tile.** Select **Underlying Filter** on the tile's option menu. It lists every filter that applies to the tile, written out for the table the tile counts through.
2. **Look for a tile filter.** A blue dot on the tile's option menu shows an active [tile filter](<https://help.apteco.com/en/orbit/dashboards/filtering/tile-filters/index.md>), which takes precedence over any conflicting user filters. Only an editor can change it.
3. **Check for Exclude User Filters.** If an editor has turned on [**Exclude User Filters**](<https://help.apteco.com/en/orbit/dashboards/tiles/tile-editor/#tile-settings>), the tile ignores user filters.
4. **Check whether it's a Pareto tile.** A Pareto tile [isn't affected by user filters from other tiles](<https://help.apteco.com/en/orbit/dashboards/tiles/tile-types/pareto-charts/#how-pareto-filters-affect-the-dashboard>).
5. **Check the table the tile counts through.** A filter on another table reaches the tile through the tile's [resolve table](<https://help.apteco.com/en/orbit/dashboards/filtering/resolve-tables/index.md>), which can change what the filter selects.

For the full rules, see [How filters combine](<https://help.apteco.com/en/orbit/dashboards/filtering/#how-filters-combine>).

## Other filter problems

These problems are about adding, applying, or changing filters.

| Symptom | Cause | Fix |
| --- | --- | --- |
| Selecting categories doesn't update the dashboard straight away | [**Auto Filter**](<https://help.apteco.com/en/orbit/reference/admin/application-settings/dashboard-settings/#auto-filter>) is turned off | **You**: build up your filter from several tiles, then apply it. **Admin**: turn on **Auto Filter** |
| A tile shows `This tile is not selectable` | **Prevent Category Selection** is turned on for the tile | **Editor**: turn off [**Prevent Category Selection**](<https://help.apteco.com/en/orbit/dashboards/tiles/tile-editor/#tile-settings>) |
| You can't add user filters | [**Allow Filter By Dimension**](<https://help.apteco.com/en/orbit/reference/admin/application-settings/dashboard-settings/#allow-filter-by-dimension>) is turned off | **Admin**: turn on **Allow Filter By Dimension** |
| You can't add a search filter | You can't edit the dashboard, or **Dashboard Search Filters** is turned off | **Editor**: [share the dashboard](<https://help.apteco.com/en/orbit/dashboards/using-dashboards/sharing-unsharing-and-group-editing-of-dashboards/index.md>) with you with **Edit** permission. **Admin**: turn on [**Dashboard Search Filters**](<https://help.apteco.com/en/orbit/dashboards/filtering/search-filters/#prerequisites>) |
| You can't edit a filter from a Venn tile | Venn filters can't be edited | **You**: delete the filter, then [select the subsets again](<https://help.apteco.com/en/orbit/dashboards/tiles/tile-types/venn-diagrams/#filter-the-dashboard-by-a-subset>) |

## Tile problems

These problems are about what a tile shows, and setting one up.

| Symptom | Cause | Fix |
| --- | --- | --- |
| A tile shows more categories than expected | The tile counts through a higher table than its own, such as **People** for a chart of bookings. A filter then selects people, and the tile shows everything they have | **Editor**: check the tile's [**Select Via**](<https://help.apteco.com/en/orbit/dashboards/filtering/resolve-tables/#when-to-change-select-via>) setting |
| The tile editor shows `Chart requires 2 dimensions.` | The chart doesn't have the dimensions or measures its type needs | **Editor**: [add them](<https://help.apteco.com/en/orbit/dashboards/tiles/tile-types/multi-dimension-charts/#add-a-multi-dimension-chart>). Most multi dimension charts need two dimensions and one measure, and combo charts need two measures |
| **Type** and **Limit** are greyed out under **Category Limit** | The editor hasn't let viewers change the limit | **Editor**: turn on [**Allow the user to adjust this limit**](<https://help.apteco.com/en/orbit/dashboards/changing-the-column-sort-order/#change-the-category-limit>) |
| The **Behaviours** tab is missing when you choose a dimension, measure, or filter | The table has no child transaction table, which behaviours need | Ask your system administrator. Behaviours need a [parent-child relationship](<https://help.apteco.com/en/orbit/dashboards/behaviours/#table-hierarchy-requirement>) between tables |
| A calculated measure doesn't match FastStats | FastStats rounds during the calculation, but Orbit calculates to a higher precision | Nothing: small differences are expected. See [Calculated measures](<https://help.apteco.com/en/orbit/dashboards/measures/calculated-measures/index.md>) |

## Export and file problems

These problems are about exporting a dashboard or a tile, and uploading files.

| Symptom | Cause | Fix |
| --- | --- | --- |
| Images are missing from a PDF export | The images are hosted on an external domain whose server doesn't send permissive cross-origin HTTP headers | Check whether the server hosting the images allows cross-origin requests. See [Export a dashboard as PDF](<https://help.apteco.com/en/orbit/dashboards/using-dashboards/export-dashboard-as-pdf/index.md>) |
| You can export a data grid tile in only one format, or not at all | **Restrict Export** is turned on for the tile | **Editor**: change or turn off [**Restrict Export**](<https://help.apteco.com/en/orbit/dashboards/tiles/tile-types/adding-data-grids-as-dashboard-tiles/#restricting-export>) |
| You can't choose **Permanent** for a URN file | All URN files in user filters are [set to be temporary](<https://help.apteco.com/en/orbit/dashboards/filtering/temporary-urn-files-in-dashboard-filters/#if-you-cant-choose-permanent>) | **Admin**: turn off **Force URN filter files to be stored temporarily** |

## Limits

These aren't faults. Orbit works this way.

| You can't | Because |
| --- | --- |
| Add a second Pareto tile to a dashboard | A dashboard can have only one [Pareto tile](<https://help.apteco.com/en/orbit/dashboards/tiles/tile-types/pareto-charts/index.md>) |
| Drill down on a profile tile | [Profile tiles](<https://help.apteco.com/en/orbit/dashboards/tiles/tile-types/profiling/index.md>) don't support drilldowns |
| Compare analysis groups side by side on one dashboard | All the profile tiles on a dashboard share the same [analysis filter](<https://help.apteco.com/en/orbit/dashboards/tiles/tile-types/profiling/analysis-filters/index.md>) |
| Use a behaviour as a measure on a Venn tile | On a [Venn tile](<https://help.apteco.com/en/orbit/dashboards/tiles/tile-types/venn-diagrams/index.md>), behaviours can only define sets |
