> ## Documentation Index > Fetch the complete documentation index at: https://docs.athelas.com/llms.txt > Use this file to discover all available pages before exploring further. # Payer Mapping **Payer mapping** connects each insurance name in your EHR to the matching payer record in Insights. Your EHR might store a plan as "BCBS of California" while the clearinghouse expects "Blue Cross Blue Shield CA" — the payer map is what bridges that gap, so you set each mapping once per insurance name instead of correcting claims one at a time. The Payer Mapping page with the Add New Mappings tab selected and four unmapped payers listed ## Why payer mapping matters | **Outcome** | **What the mapping does** | | :-------------------------- | :------------------------------------------------------------------ | | **Claims route correctly** | Each claim goes to the clearinghouse destination the payer expects. | | **Reports stay consistent** | One insurance name appears the same way across every report. | | **Payments post properly** | Remittances match back to the right payer record. | Claims for an unmapped payer may fail to submit or route to the wrong destination, so work the list as new names appear. ## Where to find payer mapping Go to **Insights → Action Items → Payer Mapping**. The page has two tabs: * **Add New Mappings** — EHR insurance names with no payer record attached yet. * **Existing Mappings** — every name you have already mapped, and where you go to correct one. ## Review your unmapped payers The **Unmapped Payers** list on **Add New Mappings** shows each unrecognized EHR insurance name alongside the volume behind that name: **# Patients**, **# Impacted Encounters**, and **# Impacted Appointments**. Sort by any of those columns to work the highest-impact names first, and use **Delete** to drop a name you do not need mapped. Names land here when: * You are setting up your practice for the first time. * A new insurance plan is added to a patient record. * An insurance name in your EHR does not match an existing mapping. ## Map a payer **To map an unmapped payer:** 1. On **Add New Mappings**, click the insurance name in **Unmapped Payers**. The header confirms your choice with **Selected:** and that name. 2. In the right panel, search by **Insurance Name or Payer ID**. Rows tagged **Recommended** are the candidates closest to the selected name, and the **(Autofill)** link above the search box proposes a match for you. The right panel listing candidate payer records with Recommended tags, Payer ID, CPID, and a Select button on each row 3. **Click** **Select** on the payer record you want. Check the **Payer ID** and **CPID** columns as you choose — those are the identifiers the clearinghouse uses to route the claim. 4. Review the **Confirm mapping** dialog, which shows the EHR insurance name above the payer record that name will map to, then **click** **Confirm**. The Confirm mapping dialog showing an EHR insurance name mapped to a payer record and its Payer ID, with Back and Confirm buttons ✨**Smart Tip:** Look for state-specific variants ("Medicare California") and plan types (HMO, PPO, Managed Medicaid) when you search. Two payer records with nearly the same name often route to different destinations. When you are not sure which payer record matches an EHR insurance name, check your contracts or fee schedules before you confirm, or ask your account team. A wrong mapping routes every future claim for that name to the wrong place. ## Correct a mapping **To change a mapping you have already saved:** 1. Open the **Existing Mappings** tab. 2. Find the mapped insurance name. 3. Edit that row and select the correct payer record. 4. Save your change. The correction applies to claims from that point forward; it does not rewrite claims that already went out. ## Things to know * **Map each name once.** A mapping applies to every patient carrying that insurance name in your EHR, so there is nothing to repeat per patient. * **A missing payer record is not a dead end.** If no record matches, your account team can add the payer or point you at the right existing record. * **Report names follow the map.** When an insurance name looks wrong on a report or a claim, the mapping is the first thing to check. * **Charge Master mapping is separate.** Mapping an unrecognized payer value during a charge-file import is a different prompt, covered in [Getting Started with Charge Master](/insights_biller/general_billing/getting_started_with_charge_master). ### FAQ Claims for that insurance name may fail to submit, or they may route to the wrong clearinghouse destination. Review the **Unmapped Payers** list regularly rather than letting it build up. No. You map an insurance name once, and the mapping covers every patient who carries that name in your EHR. Reach out to your account team. They can add a new payer record or help you identify the correct existing one to use. Insurance names on reports and claims come from the payer map, so correct the mapping on the **Existing Mappings** tab and later reports will follow. Questions about a specific mapping? Reach out to your account team or [support@getathelas.com](mailto:support@getathelas.com).