--- title: "Payroll Mapping Update 2026" slug: "payroll-mapping-update-2026" description: "2026 payroll account mapping update: new fields, changed behavior, and migration steps." updated: 2026-05-01T21:23:16Z published: 2026-05-01T21:23:16Z canonical: "docs.restaurant365.com/payroll-mapping-update-2026" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.restaurant365.com/llms.txt > Use this file to discover all available pages before exploring further. # Payroll Mapping Update 2026 A new **Payroll GL Mapping** experience is being enabled for Payroll users in 2026. Payroll GL mappings are moving from the legacy [GL Account Mapping page](/doc/docs/workforce-settings-gl-account-mapping) in the Payroll application into the Mapping Tool in a dedicated [**Payroll Accounts tab**](/doc/docs/mapping-tool-page#payroll-accounts-tab)**.** The legacy mapping tool will be deprecated at the end of April 2026 and will no longer be available. Existing payroll mappings will be migrated to the new experience where possible, with updated tools for search, filtering, and bulk editing. This change primarily impacts payroll users who manage payroll GL mapping and payroll journal entries in Restaurant365. Learn more about the new Payroll Mapping Experience: - [Mapping Tool Overview](/doc/docs/pos-mapping-tool#payroll-accounts-tab) - [Mapping Tool Page - Payroll Accounts tab](/doc/docs/mapping-tool-page#payroll-accounts-tab) - [Payroll Mapping Details](/doc/docs/payroll-account-mapping-details) - [Map Payroll Accounts](/doc/docs/map-payroll-accounts) --- ## Differences Between New and Legacy Payroll Mapping Experiences The new Payroll Mapping experience features a refreshed interface on a dedicated tab within the Mapping Tool. Core mapping concepts remain the same, but navigation, layout, and some workflows have changed. ### Navigation The Legacy GL Account Mapping tool was housed in the Payroll application, while the new Mapping Tool is in the admin application. | New Mapping Tool - Payroll Accounts Tab | Legacy GL Account Mapping | | --- | --- | | ![](https://cdn.us.document360.io/5c9d1111-0c69-4e96-8910-d7f2750fdc9d/Images/Documentation/image-NX4Q56D8.png?sv=2026-02-06&spr=https&st=2026-11-13T23%3A17%3A23Z&se=2026-11-14T00%3A17%3A23Z&sr=c&sp=r&sig=RX5h2lsKvrw0NAE%2FBdUIyNsTCwxLn7LPR58GBKJWQZg%3D) | ![](https://cdn.us.document360.io/5c9d1111-0c69-4e96-8910-d7f2750fdc9d/Images/Documentation/image-Z08SQG8Q.png?sv=2026-02-06&spr=https&st=2026-11-13T23%3A17%3A23Z&se=2026-11-14T00%3A17%3A23Z&sr=c&sp=r&sig=RX5h2lsKvrw0NAE%2FBdUIyNsTCwxLn7LPR58GBKJWQZg%3D) | ### Payroll Mapping View | New Mapping Tool - Payroll Accounts Tab | Legacy GL Account Mapping | | --- | --- | | In the New Payroll Mapping experience, each payroll code opens in a [Payroll Mapping Details](/doc/docs/payroll-account-mapping-details) screen that shows: - Code details (type and name) - Mapping type (all or legal entity - GL account selections and any legal entity specific options ![](https://cdn.us.document360.io/5c9d1111-0c69-4e96-8910-d7f2750fdc9d/Images/Documentation/image-RK5VCZEM.png?sv=2026-02-06&spr=https&st=2026-11-13T23%3A17%3A23Z&se=2026-11-14T00%3A17%3A23Z&sr=c&sp=r&sig=RX5h2lsKvrw0NAE%2FBdUIyNsTCwxLn7LPR58GBKJWQZg%3D) | Payroll mapping was separated from the Accounting mapping experience, and management often required switching between Accounting and Payroll pages. ![](https://cdn.us.document360.io/5c9d1111-0c69-4e96-8910-d7f2750fdc9d/Images/Documentation/image-91A5RWDM.png?sv=2026-02-06&spr=https&st=2026-11-13T23%3A17%3A23Z&se=2026-11-14T00%3A17%3A23Z&sr=c&sp=r&sig=RX5h2lsKvrw0NAE%2FBdUIyNsTCwxLn7LPR58GBKJWQZg%3D) | ### Multi-Entity Mapping | New Mapping Tool - Payroll Accounts Tab | Legacy GL Account Mapping | | --- | --- | | The Payroll Mapping Details screen supports: - A single default GL account for all legal entities (All), or - Different GL accounts by legal entity (Legal Entity), using a multi‑select dropdown The system prevents duplicate legal‑entity selections within the same record. ![](https://cdn.us.document360.io/5c9d1111-0c69-4e96-8910-d7f2750fdc9d/Images/Documentation/image-CPUP3C25.png?sv=2026-02-06&spr=https&st=2026-11-13T23%3A17%3A23Z&se=2026-11-14T00%3A17%3A23Z&sr=c&sp=r&sig=RX5h2lsKvrw0NAE%2FBdUIyNsTCwxLn7LPR58GBKJWQZg%3D) | Each payroll account generally mapped to one GL account, with more limited options for legal‑entity‑specific mappings. ![](https://cdn.us.document360.io/5c9d1111-0c69-4e96-8910-d7f2750fdc9d/Images/Documentation/image-ESX2TDDI.png?sv=2026-02-06&spr=https&st=2026-11-13T23%3A17%3A23Z&se=2026-11-14T00%3A17%3A23Z&sr=c&sp=r&sig=RX5h2lsKvrw0NAE%2FBdUIyNsTCwxLn7LPR58GBKJWQZg%3D) | ### Finding and Fixing Unmapped Items | New Mapping Tool - Payroll Accounts Tab | Legacy GL Account Mapping | | --- | --- | | - The Payroll Mapping grid includes search, filters, and bulk‑edit actions to quickly locate and update unmapped or incorrect items. - Validation is designed to prevent saving mappings with blank GL accounts, helping reduce posting errors. - When payroll journal entries fail due to unmapped items, messages can link back to the Mapping Tool for resolution. ![](https://cdn.us.document360.io/5c9d1111-0c69-4e96-8910-d7f2750fdc9d/Images/Documentation/image-RHWEW1AP.png?sv=2026-02-06&spr=https&st=2026-11-13T23%3A17%3A23Z&se=2026-11-14T00%3A17%3A23Z&sr=c&sp=r&sig=RX5h2lsKvrw0NAE%2FBdUIyNsTCwxLn7LPR58GBKJWQZg%3D) | Unmapped or incorrect mappings were harder to identify, and issues often surfaced only after payroll journal entries were generated and required manual corrections. | --- ## Migration of Existing Payroll GL Mappings For organizations with the new Mapping experience: - Existing payroll GL mappings migrate into the Mapping Tool where possible. - When multiple mappings exist across legal entities, the migration selects the most commonly used (majority) mapping. - Mappings tied to disabled GL accounts do not migrate and appear as unmapped in the new grid, requiring new active GL accounts. ### Payroll Account Mapping Updates In addition to the migration, a few payroll accounts have been updated as follows: - ER Taxes - Employer State Unemployment Tax Expense (which included Tax Act + Surcharge) has been split into two accounts: - ER Taxes - State Unemployment Tax Act (ER) - ER Taxes - State Unemployment Tax Act Surcharge (ER) - Two new accounts have been added: - Eugene Community Safety Payroll Tax (ER) - Child Care Contribution (ER) — Vermont - ER Taxes - General Payroll Tax Expense has been renamed to ER Taxes - Tax (Other Taxes). --- ## Permissions The new Payroll Mapping experience includes an update to how permissions are organized. - A **Mapping Tool** permission section has been added under Administration. - **Payroll GL Mapping** permissions are now located under **Mapping Tool**, and **POS Management permissions** are limited to the **POS Accounts tab**. - The **View Payroll GL Mapping** permission controls whether a user can see the Payroll Mapping tab. ### Additional considerations: - Users without access to **all active payroll locations** can view Payroll mappings but cannot edit them. [](https://docs.restaurant365.com/docs/payroll-account-mapping-details)[](https://docs.restaurant365.com/docs/mapping-tool-page) - To view **restricted GL Accounts** used in mappings, users also need **General Ledger → GL Accounts → Access Restricted GL Accounts**; otherwise, those GLs appear as **Restricted GL** in the Mapping Tool. [](https://docs.restaurant365.com/docs/mapping-tool-page) These permissions can be added to [custom user roles](https://restaurant365.us.document360.io/doc/docs/custom-user-roles) or [individual users](https://restaurant365.us.document360.io/doc/docs/users-overview-and-security). The [Permission Access report](https://restaurant365.us.document360.io/doc/docs/generating-a-permissions-access-report) can be used to determine which user roles or users already have these permissions assigned. For more information, see [User Setup and Security](/doc/docs/user-setup-security-and-location-access).