Building Your First Dashboard
Use this guide to familiarize yourself with the basics of building a dashboard and build the foundational knowledge you need to fully take advantage of dashboards and reporting in Ashby.
Permissions & access
Custom Dashboards are available on the Plus, Enterprise, and Legacy Plus plans:
Foundations | Legacy Plus | Plus | Enterprise |
|---|---|---|---|
❌ | ✅ | ✅ | ✅ |
Dashboards overview
Dashboards help to organize, present, and visualize your reports, allowing you to tailor your reports to ensure specific audiences get the most valuable information for them. You can add the same report across multiple dashboards. This ensures metrics are aligned and that team members speak the same recruiting data language.
Create a dashboard
Before creating new reports or finding reports to add to a dashboard, you need to create a dashboard. To do this:
- On the top navigation bar, click Dashboard and then select Create Dashboard
- Click the pencil icon to the right of New Report Dashboard and enter a title

- Click Save Dashboard

- When saving the dashboard, you have the option to enable Access Control. By default, dashboards are viewable by anyone in your organization. A private dashboard is only viewable by you, Organization Admins, and anyone who you specifically grant access to.
- Click Save

Create and add a new report to your dashboard
Now you can build your first report for your dashboard. You can build a report using a template as a base or create one from scratch in Build. For some report ideas, take a look at our guides Report Catalog: TemplatesReport Catalog: Templates, Report Catalog - EssentialsReport Catalog - Essentials, and Report Catalog - AdvancedReport Catalog - Advanced.
Creating a report from a template
The Template Library is a repository of pre-built reports that you can apply filters and groupings to. Before you can add a template report to your dashboard, you need to generate a report. To build a report from a template:
- Click on Reports in the top navigation bar, then Report Builder
- Click on Report Templates or select a template from the collapsible list in the left sidebar

- Optional: Add filters or groupings to the template report if needed
- Click Save Report and set your report settings on the following pop-up, including any dashboards the report should be added to.
- Click Save Report

Building a custom report
You can find further details on building custom reports at Custom ReportsCustom Reports.
Looking for information on our AI Report Builder? Check out Report Builder & AI-Assisted Report BuilderReport Builder & AI-Assisted Report Builder. Running into issues understanding your report results? Our AI Report Interpreter can generate a summary and insights. More on this at AI Report InterpretationAI Report Interpretation.
Adding your report to your dashboard
You can also add a saved report to a dashboard when viewing it.

After you save a report, the Dashboard button appears. To add the report to a dashboard:
- Click Dashboards, then + Add to Dashboard
- Search for your dashboard and check the checkbox to the left of it
- Click Add Report to Dashboards
The name of the dashboard you added the report to appears when you click the Dashboards button, and the number indicator updates accordingly.
Add a saved report to a dashboard from the dashboard page
You can add saved reports to a dashboard from the dashboard page too. To do this:
- Navigate to your dashboard at Dashboards > Saved Dashboards
- Click + Add Item, and select Report
- Search for and select the report to add it to the dashboard

Add a filter and connect it
Dashboard FiltersDashboard Filters reduce duplicative work, while also providing flexibility for the audience of the dashboard.
- To add a filter, navigate to your dashboard, make sure you are on the dashboard's Edit view, and click Add Filter.
- Find the field you would like to filter by. For filters attached to a user, use the User field. You can identify what user role you are filtering for at the report level.

- Connect the filter to each of the reports you want the filter to be applied to. When you click the filter icon on a report, Ashby prompts you to select or search for the field you want to attach the filter to. Pay attention to the subject the filter is anchored on. For example, a recruiter at the job level and the job consideration level could be different.

You can identify what reports have filters attached to them by the color of the dot next to the filter icon:
- Green: All dashboard filters apply to the report.
- Grey: Some dashboard filters apply to the report.
- Red: No dashboard filters apply to the report.
To require a filter on all reports on a dashboard, check the box next to Require value. You see the alert below if any reports aren't connected to the required filter.

Dashboard filters apply in the dashboard view and do not change the filters of the underlying report.
Delete a filter
To delete a dashboard filter, select the Trash icon next to the filter and click Delete.

Rename a filter
You can click on the pencil icon on your dashboard filter to rename it. Amend the filter name on the Change Filter Name pop-up, then click Submit to confirm.

This option allows you to customize filter names so users can clearly identify what each filter is used for. If you add multiple filters of the same type (for example, a User filter connected to the hiring manager field for a report and a User filter connected to the recruiter field of your report), this also allows you to clearly mark the difference between the two filters.
Navigate to a report vs drilling down
It is important to distinguish the difference between the way a report appears on a dashboard (especially a filtered dashboard), drill down reports, and the underlying report.
View underlying report
To view or edit the underlying report, click the Go to Report icon, located at the top-right corner of each report.
If you apply filters at the dashboard level, the icon changes to Go to Filtered Report, meaning the unsaved dashboard filters apply when you view the report. You can click Save when viewing the filtered report to add the filter changes to your existing report. If you make any changes to the underlying report and save it, these changes appear on the dashboard.
If you need to view the underlying report without any dashboard filter context applied, use the action menu on any report tile (the three dots next to the Go to Filtered Report button) to go directly to the report via Go to Report.
Drill down reports
Many of the reports you build in Ashby have drill downs available. For more on these, check out Report Drill DownsReport Drill Downs.
Organize and format
Reports appear on the dashboard as you add them. There are a couple ways you can organize and format your dashboard. If you are not able to make any changes, make sure you are in Edit mode.
Resize reports
By default, Ashby adds reports at half size, but you can customize the size of any report on the dashboard.
To adjust the size of a report, click and drag the bottom right corner of any report. Make sure to save once you are done making your changes.

Move reports
To move reports, click and drag the report to the location you would like it to be. Use the purple box that appears when you drag the report as a marker of where the report will be. Make sure to save once you are done making your changes.
Change report view
To adjust how a report displays on your dashboard, click the three dots on the report and hover over Report View to see the display options.

Add a text field
Along with adding reports and filters, you can add a text field to your dashboard. This can help with adding context, splitting your dashboard into sub-sections, and adding captions.
To add a text field:
- Click + Add Item
- Select Text
- Add your text and any formatting using the toolbar
- Click and drag the textbox to move it on your dashboard and use the arrow in the bottom-right corner of the textbox to resize as needed

You can't use text fields to add styling to dashboards. While the toolbar has code line and code block options, these just apply certain formatting to the added text.
Actions under 'More'
You can find the options below by clicking More on any dashboard.
- Allow empty spaces: Keep empty vertical space between tiles.
- Export: Download a dashboard as a PDF.
- Access: Manage who can view a dashboard.
- Share: Create a sharable link to the dashboard.
- Copy: Create a copy of a dashboard.
- Archive: Move the dashboard to the Archived folder.

FAQs
How often are reports and dashboards refreshed?
Report results refresh live when you open a report or dashboard. Ashby then caches the results for one hour. If report parameters or dashboard filters change within that hour, the report or dashboard refreshes.
You can refresh reports manually at any time on the dashboard or when reviewing a report on its own.
To refresh a report on a dashboard, click the three dots in the top-right corner of the report tile, then click Refresh Report.
Refreshing the page does not refresh a report.
Can I add the same dashboard filter type to my dashboard twice?
You can! For example, if you want to filter results by hiring manager and by recruiter, you can add two User filters to your dashboard, then connect each filter to the appropriate field on each report accordingly. We recommend renaming any duplicate filters to avoid confusion. For more on renaming dashboard filters, see Building Your First DashboardBuilding Your First Dashboard.
Adding a value to both filters means only results that match both filters' requirements on connected reports show. For example, if you set your Hiring Manager User filter to only show results where the hiring manager on the job consideration is listed as Gemma, and set your Recruiter User filter to only show results on connected reports where Tim is listed as the recruiter, only the job considerations where both Gemma is listed as the hiring manager and Tim is listed as the recruiter display on reports connected to both filters.
Can I export my dashboard?
You can, yes. Click More, then Export. Ashby exports your dashboard as a PDF.
Can I view a full-screen version of my report from the dashboard view?
Yes. To expand your report while viewing it on a dashboard, click on the square icon to the right of the report title. You can click the x on the expanded report to return to the dashboard.
