---
updatedAt: 2025-09-18T11:11:56.000Z
agentTools:
  projectIndex: https://docs.salsa.dev/llms.txt
---

# Employer dashboard

The primary entry point for an Employer facing payroll feature, it provides an overview of upcoming payroll runs, tasks, and a review of recent payroll activity.

<HTMLBlock>{`
<div style="align-items: center; display: flex;">
	<span style="font-size: var(--markdown-title-size,1.25em); font-weight: var(--markdown-title-weight,600); color: var(--markdown-title);">Available as: </span>
	<svg style="margin-inline: 4px 0px;" width="76" height="16" viewBox="0 0 76 16" fill="none" xmlns="http://www.w3.org/2000/svg">
		<rect width="76" height="16" rx="2" fill="#7C68EF"/>
		<path d="M4.75852 12V3.27273H10.6392V4.79403H6.60369V6.87358H10.3366V8.39489H6.60369V10.4787H10.6562V12H4.75852ZM12.1062 3.27273H14.3817L16.7852 9.13636H16.8874L19.2908 3.27273H21.5664V12H19.7766V6.3196H19.7042L17.4457 11.9574H16.2269L13.9684 6.2983H13.896V12H12.1062V3.27273ZM23.0866 12V3.27273H26.581C27.223 3.27273 27.7585 3.3679 28.1875 3.55824C28.6165 3.74858 28.9389 4.01278 29.1548 4.35085C29.3707 4.68608 29.4787 5.07244 29.4787 5.50994C29.4787 5.85085 29.4105 6.15057 29.2741 6.40909C29.1378 6.66477 28.9503 6.875 28.7116 7.03977C28.4759 7.2017 28.206 7.31676 27.902 7.38494V7.47017C28.2344 7.48437 28.5455 7.57812 28.8352 7.75142C29.1278 7.92472 29.3651 8.16761 29.5469 8.48011C29.7287 8.78977 29.8196 9.15909 29.8196 9.58807C29.8196 10.0511 29.7045 10.4645 29.4744 10.8281C29.2472 11.1889 28.9105 11.4744 28.4645 11.6847C28.0185 11.8949 27.4688 12 26.8153 12H23.0866ZM24.9318 10.4915H26.4361C26.9503 10.4915 27.3253 10.3935 27.5611 10.1974C27.7969 9.99858 27.9148 9.73437 27.9148 9.40483C27.9148 9.16335 27.8565 8.95028 27.7401 8.76562C27.6236 8.58097 27.4574 8.43608 27.2415 8.33097C27.0284 8.22585 26.7741 8.1733 26.4787 8.1733H24.9318V10.4915ZM24.9318 6.92472H26.2997C26.5526 6.92472 26.777 6.88068 26.973 6.79261C27.1719 6.7017 27.3281 6.57386 27.4418 6.40909C27.5582 6.24432 27.6165 6.04688 27.6165 5.81676C27.6165 5.50142 27.5043 5.24716 27.2798 5.05398C27.0582 4.8608 26.7429 4.7642 26.3338 4.7642H24.9318V6.92472ZM31.0202 12V3.27273H36.9009V4.79403H32.8654V6.87358H36.5984V8.39489H32.8654V10.4787H36.918V12H31.0202ZM41.4616 12H38.3679V3.27273H41.4872C42.3651 3.27273 43.1207 3.44744 43.7543 3.79688C44.3878 4.14347 44.875 4.64205 45.2159 5.29261C45.5597 5.94318 45.7315 6.72159 45.7315 7.62784C45.7315 8.53693 45.5597 9.31818 45.2159 9.97159C44.875 10.625 44.3849 11.1264 43.7457 11.4759C43.1094 11.8253 42.348 12 41.4616 12ZM40.2131 10.419H41.3849C41.9304 10.419 42.3892 10.3224 42.7614 10.1293C43.1364 9.93324 43.4176 9.63068 43.6051 9.22159C43.7955 8.80966 43.8906 8.27841 43.8906 7.62784C43.8906 6.98295 43.7955 6.45597 43.6051 6.04688C43.4176 5.63778 43.1378 5.33665 42.7656 5.14347C42.3935 4.95028 41.9347 4.85369 41.3892 4.85369H40.2131V10.419ZM50.1921 12H47.0984V3.27273H50.2177C51.0955 3.27273 51.8512 3.44744 52.4847 3.79688C53.1183 4.14347 53.6055 4.64205 53.9464 5.29261C54.2901 5.94318 54.462 6.72159 54.462 7.62784C54.462 8.53693 54.2901 9.31818 53.9464 9.97159C53.6055 10.625 53.1154 11.1264 52.4762 11.4759C51.8398 11.8253 51.0785 12 50.1921 12ZM48.9435 10.419H50.1154C50.6609 10.419 51.1197 10.3224 51.4918 10.1293C51.8668 9.93324 52.1481 9.63068 52.3356 9.22159C52.5259 8.80966 52.6211 8.27841 52.6211 7.62784C52.6211 6.98295 52.5259 6.45597 52.3356 6.04688C52.1481 5.63778 51.8683 5.33665 51.4961 5.14347C51.1239 4.95028 50.6651 4.85369 50.1197 4.85369H48.9435V10.419ZM55.8288 12V3.27273H61.7095V4.79403H57.674V6.87358H61.407V8.39489H57.674V10.4787H61.7266V12H55.8288ZM66.2702 12H63.1765V3.27273H66.2958C67.1737 3.27273 67.9293 3.44744 68.5629 3.79688C69.1964 4.14347 69.6836 4.64205 70.0245 5.29261C70.3683 5.94318 70.5401 6.72159 70.5401 7.62784C70.5401 8.53693 70.3683 9.31818 70.0245 9.97159C69.6836 10.625 69.1935 11.1264 68.5543 11.4759C67.918 11.8253 67.1566 12 66.2702 12ZM65.0217 10.419H66.1935C66.739 10.419 67.1978 10.3224 67.57 10.1293C67.945 9.93324 68.2262 9.63068 68.4137 9.22159C68.604 8.80966 68.6992 8.27841 68.6992 7.62784C68.6992 6.98295 68.604 6.45597 68.4137 6.04688C68.2262 5.63778 67.9464 5.33665 67.5742 5.14347C67.2021 4.95028 66.7433 4.85369 66.1978 4.85369H65.0217V10.419Z" fill="white"/>
	</svg>
</div>
`}</HTMLBlock>

<Image alt="Employer dashboard" align="center" border={true} src="https://files.readme.io/763ec5d-admin.internal.salsa.dev_elements_employer-dashboard_userTokeneyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJhcGljbGllbnRfZTZlNTVjMzItNjM2MC00MWZmLWJmYzgtNWQ3YzQxMzUzMTEzIiwicm9sZSI6InNhbHNhLWFkbWluIiwiZXhwIjoxNjkxODYyMzUyLCJ0eXBlIjoic2Fsc2EifQ.kmqLEKkEK.png">
  Employer dashboard experience
</Image>

# Options

| Name                    | Type                        | Description                                                                                                                                                                                                                                |
| :---------------------- | :-------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `userToken`             | *String*                    | ***Required.*** A <Glossary>User Token</Glossary> with `EMPLOYER_ADMIN` access role for the specified Employer.                                                                                                                            |
| `employerId`            | *String*                    | ***Required.*** The id of the Employer.                                                                                                                                                                                                    |
| `showPayrollRunReports` | *Boolean*                   | A flag that determines if the *Download Cash Requirements Report*  and *Download Payroll Journal Report* buttons are shown on each payroll run in the payroll run list.  If omitted, defaults to *true*.                                   |
| `runPayrollOptions`     | *RunPayrollReadOnlyOptions* | Options for configuring what elements should be shown as read only in the run payroll experience. See the [Run Payroll reference](https://docs.salsa.dev/reference/run-payroll#optionsreadonly-properties) for the options object details. |

Refer to the [reference on creating elements](https://docs.salsa.dev/reference/salsajs#create-an-element) for the additional options that are available to all elements.

# Embedded usage

**Element name:** `employer-dashboard`

Refer to the guide on how to [embed an Element with Salsa.js](https://docs.salsa.dev/docs/embedding-a-component) for more detailed instructions.

## Example

```javascript
salsa.elements.create('employer-dashboard', {
  userToken: 'eyJhbGciO...ajs0Wqw', 
  employerId: 'er_e8343fc7-9d63-4cc5-81ed-c573fc666d37'
});
```