What This Screen Does

This is where you update an existing wage rate in the system. Think of a wage rate as a pay-rate card that tells the payroll system how much to pay per hour for a certain type of work. On this screen you can change the name, external ID, payroll system, or hourly amount for a wage rate that was already created.

How to Get There

Open the dashboard.
In the left-hand menu, click Wage Rate.
Find the wage rate you want to change in the list.
Click on it (or click its edit action).
You are now on the Edit Wage Rate screen.

Step-by-Step Guide

1. Review the Breadcrumbs

At the top of the page you will see a breadcrumb trail: Dashboard → Wage Rate → [Name of this wage rate].
This confirms you are editing the correct wage rate.

2. Update the Details

All four fields are required. The form is pre-filled with the wage rate’s current values. Change only what you need.

Field	Required	What to Enter
Name	Yes	A descriptive name for this wage rate (e.g. “Weekend Evening Rate”). This is how it appears throughout the system.
External ID	Yes	The matching ID in your payroll system. It must be exactly the same as the one used in the payroll software so the two systems stay in sync.
Payroll System	Yes	The payroll provider this wage rate belongs to. Currently the only option is Danloen.
Hourly rate	Yes	The amount paid per hour. Enter a number greater than zero. The currency symbol shown is based on your organization’s default currency setting. You can use commas in the number (e.g. `1,250`).

3. Save Changes

Click the Save Changes button at the bottom-right of the form.
The system will:
1. Validate all fields.
2. Send the updated data to the server.
3. Redirect you back to the Wage Rate list.
You will see a green “Update success!” notification at the bottom of the screen.

What Happens Behind the Scenes

You click "Save Changes"
        |
        v
Form validates all fields (Yup schema)
  - Name must not be empty
  - External ID must not be empty
  - Payroll System must be selected
  - Hourly rate must be a number greater than 0
        |
        v
API call: WageRatesService.edit({ id, body: { id, name, externalId, payrollSystem, amount } })
        |
        v
Server updates the wage rate record and returns a success response
        |
        v
Success notification "Update success!" appears
        |
        v
You are redirected to /wage-rates (the wage rate list)

Troubleshooting

“I filled everything in but the Save Changes button does not work”

Make sure every field has a value. All four fields — Name, External ID, Payroll System, and Hourly rate — are required.
Look for small red error messages below the fields. They tell you exactly what is missing or wrong.
If the Hourly rate field is highlighted, make sure you entered a number greater than zero.

“The form is empty — none of the current values are showing”

The system loads the wage rate data when the page opens. If your internet connection is slow, it may take a moment.
Try refreshing the page. If the fields are still empty, the wage rate may have been deleted or the ID in the URL may be incorrect.
Go back to the Wage Rate list and click the correct wage rate to try again.

“I see a red error message after clicking Save Changes”

A red alert box will appear at the top of the form with details about the problem.
Read the message carefully — it usually comes from the server and explains what went wrong (for example, a duplicate External ID).
Fix the issue described in the message and try saving again.
If the error is unclear, contact your administrator and share the exact error text.

“The Hourly rate keeps showing as invalid”

The hourly rate must be a number greater than zero. Entering 0 or leaving the field blank will trigger a validation error.
You can use commas in the number (e.g. 1,250), but do not use letters or special characters other than commas and decimals.
The currency symbol next to the field is based on your organization’s default currency and cannot be changed on this screen.

“I cannot find the wage rate I want to edit”

Go back to the Wage Rate list and use sorting or scrolling to locate it.
If the wage rate is not in the list, it may have been deleted by another user.
Check with your administrator if you believe it should still exist.

“The page shows a loading spinner that never stops”

This usually means the API call to fetch the wage rate data is taking too long or has failed.
Check your internet connection and refresh the page.
If the problem continues, the server may be experiencing issues — try again later or contact support.

Currently, Danloen is the only supported payroll system. This is not an error.
If your organization uses a different payroll provider, contact your administrator or support team to discuss options.

“My changes were not saved even though I saw the success message”

Go back to the Wage Rate list and open the wage rate again to confirm the values were updated.
If the old values are still showing, try clearing your browser cache and refreshing.
If the issue persists, there may have been a server-side problem — try editing the wage rate again.

Edit Bookkeeping Settings

Employee Details

Edit a Lock

Create a New Wage Rate

Wage Rate List