Quick Fix Table

Error	Most Common Cause	Quick Fix	Need Care Agent?
Unable to edit deductions	Payroll has already been posted; browser cache is causing the error	Refresh browser; check payroll status	Only if the fix still fails
Your payroll failed to reset	System glitch during payroll reset	Refresh page; clear browser cache; try again	If this error persists
Your payroll failed to open	Missing time entries; permission issue	Check if time clocks synced; verify payroll access	Check access first
Your payroll cannot be calculated	Missing employee setup; time entry gaps	Complete employee tax info; verify time entries	Likely solved by the customer
Your payroll failed to post	Data validation issue; posting conflict	Review all fields; check for duplicate posting	Very likely needs agent
Unable to save earning	Duplicate earning type; bad data	Clear browser cache; verify earning is configured	Try refresh first

Understand Payroll Errors and What They Mean

Payroll errors fall into three categories:

Access or Permission Errors (You can't open or edit)
1. Usually means: You don't have payroll permissions or the payroll is locked
2. Solution: Often self-service (refresh, clear cache, verify permissions)
Setup or Data Errors (Toast can't calculate or save)
1. Usually means: Missing employee info, time entries, or deduction setup
2. Solution: Typically self-service (complete setup, verify data)
System Errors (Network glitch, database issue)
1. Usually means: Temporary system issue or bug
2. Solution: Refresh/retry or contact Care if persistent

Use the decision tree below to diagnose your error.

Toast Payroll Error Decision Tree

Are you an HR+ user? HR+ users are the only ones who should encounter these errors since they are the only ones who can access payroll.
Which error message did you receive?
1. Not seeing your error above? Skip to .
Unable to Edit Deductions
1. What This Error Means: You selected Edit on a deduction (or tried to add a new one) and Toast returned an error instead of opening the edit screen.
2. Most Likely Causes:
  1. Browser cache/session issue
    Your browser is holding old data and not syncing with Toast.
    Solution: Refresh and clear your cache.
  2. Deduction is inactive
    The deduction you're trying to edit isn't active this pay period.
    Solution: Ask Care to check the settings or create a new deduction.
  3. Payroll is already posted
    Once you select Post Payroll, the payroll is locked and cannot be edited.
    Solution: You'll need to void and re-record.
3. Step-by-Step Troubleshooting:
  1. Step 1: Check if Payroll is Posted
    In Toast Payroll, select Payroll.
    Look at the Status column of your payroll run.
    
    If status is Draft: Payroll is not posted, continue to the next step.
    If you do not see the payroll here, check the Past Payrolls tab. If it appears there, it has already been posted. Skip to .
  2. Step 2: Refresh Browser and Try Again
    Press Ctrl+Shift+R (Windows) or command+Shift+R (Mac) to hard refresh
    This clears browser cache while reloading the page
    
    Navigate back to Payroll.
    Try editing the deduction again.
    If the error persists, continue to the next step.
  3. Step 3: Clear Browser Cache Completely
    Chrome steps:
    Select Menu (⋮) > Settings > Privacy and security > Clear browsing data.
    Select All time, then check Cached images and files, and finally select Clear data.
    
    Safari steps:
    Navigate to Preferences > Privacy > Manage Website Data > Select all > Remove.
    
    Firefox steps:
    Navigate to Settings > Privacy & Security > Cookies and Site Data > Clear Data.
    
    Refresh the page and try again.
    If the error persists, continue to the next step or contact Customer Care.
  4. Step 4: Check the Deduction Status
    Can you add the deduction anywhere else in payroll?
    If not, contact Customer Care to check the status of the deduction.
    If so, the deduction should be editable for any employee. Continue to the next step.
  5. Step 5: Your Payroll is Posted
    If your payroll has already been posted, it cannot be edited. In this case, you should create a quick calc with the designated deduction edits:
    In Toast Payroll, navigate to the employee's profile.
    Select Quick Calc.
    Select Start.
    Select the yellow Actions star.
    You may already see earnings and/or deductions in this table. These will automatically appear if an individual has a recurring earning and/or deduction code that applies to them every pay period (for instance, a salaried user will see their pay period's gross salary amount).
    
    Select Add Earning and then Submit.
    Add the missed pay here:
    Check Type: Leave as Manual Check.
    Earning Type: Select an earning code.
    Hours: Enter the number of hours here for hourly earnings.
    Amount: Enter a dollar amount here for salary or flat-rate earnings.
    
    Note: Enter either Hours or Amount, but not both. This depends on the Earning Type you selected above.
    
    Week: For biweekly payrolls, enter which week you would like to apply the earning.
    
    Select Add Earning to finalize. Selecting Save and Add allows you to add multiple entries at once.
    Once all necessary earnings and/or deductions have been added to this quick calc, select the yellow Actions star once more and choose Calculate Gross to Net and Submit.
    At this point, you can pay your employee the net pay amount. This number is based on the deductions and taxes that Toast Payroll will apply to this employee. Continue these steps to apply the quick calc to a payroll.
    Scroll down and choose the payroll to apply this quick calc to.
    If applicable, enter a check number.
    Select Submit.
Your Payroll Failed to Reset
1. What This Error Means: You selected Reset payroll (to undo changes and start over), but Toast couldn't complete the reset operation.
2. What Resetting a Payroll Does:
  1. Clears all manual edits you've made to the payroll.
  2. Reloads original time clock data.
  3. Does not affect already-posted payrolls.
3. Most Likely Causes:
  1. Browser session expired
    Your login session timed out.
    Solution: Log out and log back in.
  2. Payroll is too old or archived
    The payroll is from 90+ days ago. Additionally, Toast can't reset archived payrolls.
    Solution: Contact Toast support.
4. Step-by-Step Troubleshooting:
  1. Step 1: Refresh and Retry
    Press Ctrl+Shift+R (Windows) or command+Shift+R (Mac) to hard refresh.
    This clears browser cache while reloading the page.
    
    In Toast Payroll, select Payroll.
    Open your payroll run and select Reset payroll.
    If the error persists, continue to the next step.
  2. Step 2: Log Out and Log Back In
    In the upper-right corner of Toast Payroll, select the avatar icon > Logout.
    Wait 30 seconds.
    Go to https://www.toasttab.com and log back in.
    In Toast Payroll, select Payroll.
    Open your payroll and select Reset payroll.
    If the error persists, continue to the next step.
  3. Step 3: Clear Cache and Try Again
    Follow the steps in .
    In Toast Payroll, select Payroll.
    Open your payroll and select Reset payroll.
    If the error persists, continue to the next step.
  4. Step 4: Check Payroll Age
    Look at the payroll run you're trying to reset.
    Is the Pay Period End Date more than 90 days in the past?
    If yes, this payroll is archived. You cannot reset it. Contact Toast support if you need to modify it.
    If not, contact Customer Care.
Your Payroll Failed to Open
1. What This Error Means: You clicked to open a payroll run for editing, but Toast couldn't load it. The payroll might not load, or loads partially.
2. Most Likely Causes
  1. Time clock data hasn't synced
    Your time clocks are connected, but Toast hasn't pulled time entries yet. This can happen with a newly-created payroll.
    Solution: Wait 15-30 minutes, then try again.
  2. Browser issue/cache
    Browser cache is holding stale data.
    Solution: Hard refresh and clear cache.
3. Step-by-Step Troubleshooting
  1. Step 1: Wait for Time Clock Sync
    If you just created this payroll run (less than 30 minutes ago), your time clocks may not have synced yet.
    Time entries usually sync within 5-15 minutes, but can take up to 30 minutes.
    Wait 30 minutes, then try opening the payroll again.
    If employees still show zero hours, continue to the next step.
  2. Step 2: Verify Time Entries Are Being Recorded
    In Toast Web, navigate to the Labor Summary in the Quick Actions menu.
    Check if employees have clocked in/out recently.
    Compare this to the time entries in Toast Payroll under Time.
  3. Step 4: Hard Refresh Browser
    Press Ctrl+Shift+R (Windows) or command+Shift+R (Mac) to hard refresh.
    This clears browser cache while reloading the page.
    
    In Toast Payroll, select Payroll.
    Try opening the payroll again.
    If the error persists, contact Care.
Your Payroll Cannot Be Calculated
1. What This Error Means: You tried to calculate the payroll, but Toast couldn't complete the calculation. This prevents the payroll from processing.
2. Most Likely Causes
  1. Browser issue/cache
    Browser cache is holding stale data.
    Solution: Hard refresh and clear cache.
3. Step-by-Step Troubleshooting
  1. Step 1: Refresh and Retry
    Press Ctrl+Shift+R (Windows) or command+Shift+R (Mac) to hard refresh.
    This clears browser cache while reloading the page.
    
    Navigate back to your payroll run.
    Try calculating again.
    If the error persists, continue to the next step.
  2. Step 2: Log Out and Log Back In
    In the upper-right corner of Toast Payroll, select the avatar icon > Logout.
    Wait 30 seconds.
    Go to https://www.toasttab.com and log back in.
    In Toast Payroll, select Payroll.
    Open your payroll and select Reset payroll.
    If the error persists, Contact Customer Care.
Your Payroll Failed to Submit
1. What This Error Means: You selected Submit payroll, but Toast couldn't complete the posting.
2. Most Likely Causes:
  1. Data validation issue
    Some field fails validation. For instance, an amount is out of range, there's invalid data type, etc.
    Solution: Contact Customer Care.
  2. Duplicate posting attempt
    Payroll was actually posted, but you selected Submit payroll again before the page updated.
    Solution: Refresh and check if payroll is already posted
  3. System error during posting
    Either a database write failed or a network issue occurred during posting.
    Solution: Retry submitting your payroll. If the error is persistent, contact Customer Care.
3. Step-by-Step Troubleshooting:
  1. Step 1: Check if Payroll Already Posted
    In Toast Payroll, select Payroll.
    Look at the Status column of your payroll run.
    
    If status is Draft: Payroll is not posted, continue to the next step.
    If you do not see the payroll here, check the Past Payrolls tab. If it appears there, it has already been posted. No action needed.
  2. Step 2: Refresh and Retry
    Press Ctrl+Shift+R (Windows) or command+Shift+R (Mac) to hard refresh.
    This clears browser cache while reloading the page.
    
    In Toast Payroll, select Payroll.
    Try posting the payroll again.
    If the error persists, continue to the next step.
  3. Step 3: Log Out and Log Back In
    In the upper-right corner of Toast Payroll, select the avatar icon > Logout.
    Wait 30 seconds.
    Go to https://www.toasttab.com and log back in.
    In Toast Payroll, select Payroll.
    Open your payroll and select Reset payroll.
    If the error persists, continue to the next step.
  4. Step 4: Contact Toast Support
    Payroll posting failures usually indicate a data validation issue that requires Toast support to investigate. When you contact support, provide:
    Payroll check date
    Number of employees
    Any error messages you see (take a screenshot)
    Whether the error is consistent or intermittent
    Expected timeline: 2-4 hours for resolution.
Unable to Save Earning
1. What This Error Means: You tried to add or edit an earning type in the payroll (e.g., hourly wages, bonus, overtime) but Toast couldn't save the change.
2. Most Likely Causes
  1. Duplicate earning type
    
    You're trying to add an earning that already exists for this employee in this pay period.
    Solution: Edit the existing earning instead of adding a new one.
  2. Browser cache/session issue
    Your browser is holding stale data.
    Solution: Clear cache and refresh.
  3. Invalid earning configuration
    The earning type itself is misconfigured.
    Solution: Contact Customer Care
3. Step-by-Step Troubleshooting
  1. Step 1: Hard Refresh Browser
    Press Ctrl+Shift+R (Windows) or command+Shift+R (Mac) to hard refresh.
    This clears browser cache while reloading the page.
    
    Navigate to your payroll run.
    Try saving the earning again.
    If the error persists, continue to the next step.
  2. Step 2: Log Out and Log Back In
    In the upper-right corner of Toast Payroll, select the avatar icon > Logout.
    Wait 30 seconds.
    Go to https://www.toasttab.com and log back in.
    In Toast Payroll, select Payroll.
    Open your payroll and select Reset payroll.
    If the error persists, contact Customer Care.
Other Errors Not Listed
1. If you're seeing an error message that's not in the above sections:
  1. Note what you were doing when the error occurred:
    
    Was it opening payroll? Editing? Calculating? Posting?
    Which employee or field?
  2. Try these quick fixes:
    Press Ctrl+Shift+R (Windows) or command+Shift+R (Mac) to hard refresh.
    This clears browser cache while reloading the page.
    
    Log out and log back in.
  3. Still seeing the error? Contact Toast support with:
    A screenshot of the error.
    What you were doing when it occurred.
    Your payroll details (name of payroll, check date).
    Your browser type (Chrome, Safari, Firefox, Edge).

Additional Resources

This content is for informational purposes and is not intended as legal, tax, HR, or any other professional advice. Please contact an attorney or other professional for advice.

Get Help With User Permissions for Toast POS

Toast Payroll: Get Started With Deduction Codes

Tips Manager With Toast Payroll

Toast Payroll: Review Payroll Reports

Toast Payroll: Get Help With Custom Imports