BeyondERP.Newsletter
Menu

Setup step on the Language codes page · Human resources

Set up Language codes

Use this page to create a code for each language, and each dialect if needed, so that the native language of workers and applicants can be recorded.

Used by
Compensation and benefits manager, Human resource assistant, Human resource manager and 3 more roles
Business process
Develop people strategy
Menu item
HcmLanguageCode
Main table
HcmLanguageCode
Data entity
HcmLanguageCodeEntity
Setup steps
1 on this page
Show what matters for
SETUP GUIDEHow to set it up8 sections. Choose a role to highlight what matters to you.
Everyone

1What it is and why

What it isA setup page that holds the list of language codes used in Human resources.
What you do hereUse this page to create a code for each language, and each dialect if needed, so that the native language of workers and applicants can be recorded.
ExampleFor example, BEAT creates the language codes EN-US, ES-MX and DE; 12 workers in the Texas office have ES-MX as native language on their personal details, which HR uses when it plans bilingual service roles.
Language codes page in Dynamics 365
The page in Dynamics 365. page title tab to open what to set or check
Functional consultant · Solution architect

2Where it fits

Business processDevelop people strategy
Menu pathHuman resources › Setup › Language codes
Used next byWorkers (native language on personal details) Microsoft Learn
Related pagesEthnic origins Microsoft Learn
In this process Set up Vesting rules · Set up Per diems
End user · Functional consultant

3How to do it

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.

Setup steps on this page

Set up Language codes

Use this page to create a code for each language, and each dialect if needed, so that the native language of workers and applicants can be recorded.

How to use it

  1. Go to Human resources > Setup > Language codes.
  2. Use the Filter box to find a row.
  3. Select New and enter the Language code and its Description.
  4. Review the Language code and Description columns.
  5. Select Save; select Delete to remove a selected row.

Source: Checked in Dynamics 365

Fields on the page

FieldWhat it meansExampleTable column
Language codeAn identifier for the language.Microsoft Learn ES-MXLanguageCodeId
DescriptionA description of the language code.Microsoft Learn Spanish (Mexico)Description

Common errors and fixes

MessageWhat to do
A worker's native language can't be selectedThe language code doesn't exist. Add it here, then set it on the worker's personal details. Microsoft Learn

Test checklist

  1. Create the language code ES-MX with a description.
  2. Set it as native language on a worker's personal details.
  3. Filter Workers on native language ES-MX and check the worker is listed.

Source: Microsoft Learn

Functional consultant

4Setup decisions

Setup stepRecommended value and whyDecision, common mistake and test
Set up Language codesOne code per language the workforce speaks, with dialect codes only where staffing needs them, set up before worker personal details are loadedWorker personal details point to the language code ID for the native language.How detailed should language codes be?Loading worker personal details before the language codes: the native language ID has nothing to point to.Test: Native language on a worker

Feature management and licence

Licence or add-inHuman resource assistant maintains the list; Human resource manager, Compensation and benefits manager, Recruiter, Payroll administrator and Payroll manager view it. No Feature management feature is needed for this page.

Microsoft Learn

Solution architect

5Design impact

Shared or per companyShared: language codes are not per company. Data management lists the Language codes entity as shared. Checked in Dynamics 365
Can it be undoneHard to reverse: Workers point to the code ID, so renaming a code means updating every worker that uses it.
If you change it laterWorker personal details store the native language as the language code ID, which is synchronized to Dataverse through the Language codes to language mapping, so renaming a code means updating the workers that use it. Microsoft Learn
Technical architect

6Technical

Menu itemHcmLanguageCode Checked in Dynamics 365
FormHcmLanguageCode Checked in Dynamics 365
TableHcmLanguageCodeShown as “LANGUAGE CODES” in Record infoKey field: LanguageCodeIdChecked in Dynamics 365
Data entitiesHcmLanguageCodeEntityLanguage codes Microsoft data model
Who can open itPrivilegesMaintain language codes HcmLanguageCodeMaintainView language codes HcmLanguageCodeViewDutiesEnable workforce management process HcmWorkforceProcessEnableInquire into workforce management process HcmWorkforceProcessInquire
6 security rolesCompensation and benefits manager HcmCompensationAndBenefitsManagerHuman resource assistant HcmHumanResourceAssistantHuman resource manager HcmHumanResourceManagerPayroll administrator HcmPayrollAdministratorPayroll manager HcmPayrollManagerRecruiter HcmRecruiter
Checked in Dynamics 365
Roles to set it up and use itTo set it up or change itHuman resource assistant HcmHumanResourceAssistantTo use itHuman resource manager HcmHumanResourceManagerCompensation and benefits manager HcmCompensationAndBenefitsManagerRecruiter HcmRecruiterPayroll administrator HcmPayrollAdministratorPayroll manager HcmPayrollManagerGive people one of these roles. On this system, 6 roles can open this page.Checked in Dynamics 365
Developer

7Developer

Open it by URLhttps://<your-environment>/?mi=HcmLanguageCode
Integrate withHcmLanguageCodeEntity data entity Microsoft data model
Data migrationHcmLanguageCodeEntity Language codes. Shared by all companies.Load order: Load with the Personnel management setup template, which lists: External links groups, Loan types, Media types, Regulatory establishments, Terms of employment, External links, Loan items, Media, Regulatory establishment details, Headquarters establishment for company, Ethnic origins, Issuing agency, Language codes, Reason codes, Titles, Veteran status, Levels, Compensation regions, Identification type, Screening type. Language codes has no dependency inside the template; load it before worker personal details.Microsoft Learn
Everyone

8Sources

To cite this step: HR-SETUP-090, Set up Language codes. Beyond ERP Atlas Hub, 2026-11-11. https://www.beyonderp.cloud/atlas/step/HR-SETUP-090