SETUP GUIDEHow to set it up8 sections. Choose a role to highlight what matters to you.
Everyone
1What it is and why
What it is
A report that counts the workers employed on a date you enter, with or without contractors.
What you do here
Use this page to get a headcount on a given date, for the whole company or for the workers you filter on.
Example
For example, at month end on 31 October 2026 BEAT runs the report with Include contractors on and gets 212 workers, matching the 198 employees and 14 contractors on the Employees and Contractors tiles.
The page in Dynamics 365. page title tab to open what to set or check
About the examples: Examples and screenshots in this guide use BEAT, a demo company in a Dynamics 365 test environment. Use your own company's codes and values instead of copying them.
When to run it
When to run it
When you need a headcount on a given date, for example at month end or for a management report.
How often
On demand, often at each month or quarter end.
What the output shows
The number of workers employed on the date you entered. A count that is too low usually means contractors are excluded or workers have no employment on that date.
The total is lower than the Employees and Contractors tiles
The report leaves contractors out unless Include contractors is on, while the tiles show both. Turn it on, or compare with the Employees tile only. Microsoft Learn
A known worker isn't counted
The worker has no employment on the date. Check the employment dates, or the Workers without employment page. Microsoft Learn
Run it on each month or quarter end with that date and Include contractors set the same way every time.The Employees and Contractors tiles show today's count only; the report gives the count for the date you need.
Shared worker data: Data management lists the Worker, Employment V2 and Person details entities as shared, so the report reads the same worker records from any legal entity; narrow it with Records to include. Checked in Dynamics 365
Can it be undone
Nothing to undo: The report only counts workers.
If you change it later
The count reads the employments valid on the date entered; hires and terminations recorded later with dates before that date change a rerun for the same date. Microsoft Learn
Technical architect
6Technical
Menu item
HRMNumberOfWorkersChecked in Dynamics 365
Form
SysOperationTemplateFormChecked in Dynamics 365
Roles to set it up and use it
To use itHuman resource manager HcmHumanResourceManagerHuman resource assistant HcmHumanResourceAssistantCompensation and benefits manager HcmCompensationAndBenefitsManagerRecruiter HcmRecruiterPayroll administrator HcmPayrollAdministratorGive people one of these roles. On this system, 9 roles can run this page.Checked in Dynamics 365
Developer
7Developer
Open it by URL
https://<your-environment>/?mi=HRMNumberOfWorkers
Data migration
Load order: The Number of workers report has no data entity in Data management, so it can't be loaded from a file or a configuration template. It reads the worker and employment records; load them with the Worker data migration template and run the report in each environment.Microsoft Learn