Payroll teams sometimes need to update tax setup parameters after a document has already been uploaded. Before this enhancement, those changes depended on manual support or separate maintenance workflows outside Payroll, which slowed down routine updates and made it harder for administrators to see current and future tax settings in one place.
This was especially painful for those managing state-specific tax rules and effective-dated changes, where timing and clarity matter. It also increased operational friction for straightforward updates that users should be able to handle on their own with the right controls.
"Tax Updates" brings tax setup-parameter maintenance into Payroll so eligible administrators can review tax settings by state and update tax data, such as State unemployment insurance rates, Employer tax account numbers, and Tax Deposit Frequencies
This allows you to:
- Save time — Payroll admins can make routine tax parameter updates directly in Payroll instead of relying on support-driven changes.
- Improve visibility — Users can review tax settings by state and see both current and future-dated versions during the edit process.
- Reduce update errors — The experience clearly separates editing an existing value from creating a new future-dated value.
- Support compliance-sensitive workflows — The feature includes acknowledgment language and effective-date guardrails appropriate for tax-related changes.
- Handle provisional values more clearly — Government-issued parameters that support provisional status include checkbox behavior and help text indicators.
Feature Details
How Feature Is Accessed
After the relevant tax document has been uploaded, users can open Setup Parameters within Payroll to review tax settings organized by state. The list view shows the most recent effective date for each parameter and keeps future-dated entries out of the summary view until the user enters edit mode.
What Users Do
1. Review setup parameters by state within Payroll instead of leaving the product or requesting manual help.
2. Edit the value of an existing parameter when that parameter is allowed to be updated.
3. Create a new version of a parameter with a new value and a future effective date.
4. View the current version and all future-dated versions of a parameter while editing.
5. Use provisional checkboxes for applicable government-issued items and access a help icon that explains the provisional state.
Behavior and Guardrails
The feature does not allow users to change the effective date of an existing parameter. Instead, users either update the current value or create a new future-dated value. Newly added effective dates cannot be in the past.
Both edit flows display the following legal acknowledgment message: “In order to modify any company tax values, you must be the record creator. By modifying tax values, you are legally acknowledging that you are the record creator for this account.”
Examples
FAQs
- Can users change the effective date on an existing tax parameter?
- No. Users can update the value of an existing parameter, but they cannot change its existing effective date. To make a dated change, they must create a new version with a future effective date.
- Can users create tax changes that take effect in the past?
- No. New effective dates must be in the future.
- Will users see future-dated parameter versions on the main list?
- No. The list view shows the most recent effective date only. Current and future-dated versions become visible when the user enters the edit flow for a parameter.
- Does the feature support provisional tax values?
- Yes, for applicable government-issued items. Those parameters can include a provisional checkbox and a help icon that explains the provisional state.
- How is access controlled?
- The workflow is gated by the Setup Parameters feature flag and is intended for authorized users managing company tax values in Payroll.