Map unmapped stages
Purpose
This article guides you through mapping ATS stages to stage groups in the Configure stages step of Analytics Product Setup. Mapping ensures every stage in your ATS is accounted for in funnel metrics. Unmapped stages are excluded from all funnel calculations and can cause count mismatches across dashboards.
Audience
New users, administrators (admins), solution architects, partners, and Eightfold employees.
Getting Started
- Navigate to Admin Console > Home > Product Setup.
- Under Analytics, click Set up.
- Click Configure stages.
The Configure stages page displays a kanban view. Each column is a stage group. The Unmapped stages panel on the left lists all ATS stages that have not yet been assigned to a group.
Note: An error banner appears if any required Eightfold standard stage groups are not yet mapped. Resolve this before saving.
Mapping unmapped stages
- In the Unmapped stages panel, locate the stage you want to map.
- Drag it into the appropriate stage group column.
- The stage is now assigned to that group and will be included in funnel metrics.
Repeat for all stages in the Unmapped stages panel. Ensuring no stage is left unmapped means all stages are accounted for in your metrics.
Using the Filter to find stages
Use the Filter stages search bar at the top right of the page to locate a specific stage quickly across both the Unmapped stages panel and the stage group columns.
Understanding the error banners
| Banner | What it means | How to fix |
| Required Eightfold standard stage groups are not yet mapped | One or more of the required EF standard stages (e.g., EF_New Application, EF_Phone Interviews) has no stage group assigned to it | Assign at least one ATS stage to a group mapped to each required EF standard stage |
| Stage group order is invalid | The mapped Eightfold standard stage groups are not in the required sequence | Reorder the stage group columns to match the required order: New Application → Phone Interviews → Onsites → Offer → Hired |
Warning: If your stage mapping results in an inverted funnel — where a downstream stage group has more applications than an upstream one — a warning indicator appears. Review your stage assignments and resolve the inversion before saving.
Usage
Required/Optional: Required
Format: Drag and drop
Tips
- Regularly check for unmapped stages and ensure they are correctly assigned to the appropriate stage groups. This helps maintain accurate metrics and a smooth recruitment process. If you create new stages in your ATS after your initial setup, any unmapped stages will trigger a failing health rule notification.
- A healthy funnel should show progressively fewer applications as stages advance. If counts appear out of order, review which stages are assigned to which groups.
- If a warning indicator appears for an inverted funnel, review your stage groupings to ensure stages are mapped in the correct order relative to your hiring process.
FAQs
Why is it important to map all stages?
Properly mapping all stages ensures accurate tracking of candidate progress and reliable funnel metrics. Unmapped stages are excluded from calculations, which can cause discrepancies across dashboards.
What does the inverted funnel warning mean?
An inverted funnel occurs when a downstream stage group has more active applications than an upstream one. This typically indicates a mapping error. Review your stage assignments to ensure the order reflects your actual hiring flow.
Where do the pre-seeded stage values come from?
Stage values come from analytics_db and ats_config.
If we add new stages or a new stagemap, where does this update?
Since analytics is one of the sources, even if there is more than one system, new stages will appear in the Unmapped stages panel for you to map.