HR Settings (HCM)

This page documents the shipped HR Settings area (hcm-foundation) — the central place an HR administrator configures how HCM behaves for their company. Not for plugin developers; if you're adding a new settings group of your own, treat this as a working example to copy, not a guide to read first.

Who this is for: the HR Settings Administrator role. Everyday settings you can just save yourself; a few sensitive ones need a second person to approve the change before it takes effect (see Approvals for sensitive settings below).

Getting there

/app/hcm/administration/hcm-foundation/hr-settings — the Overview page, a grid of 12 setting-category cards.

The Overview page

Nine tabs across the top — Overview, Policies, Workflows, Notifications, Integrations, Security, Compliance, Custom Fields, System — switch between them instantly, no page reload. Overview shows all 12 category cards together; each other tab zooms into one category at a time.

Not every category is fully built yet. Click Manage on a card and you'll land on that category's real settings screen; click a card that still says Coming soon and there's nothing there yet:

Works today (Manage)	Not yet (Coming soon)
Organization	HR Policies
Compensation	Workflows
Attendance	Notifications
Employee	Integrations
Compliance	Security
System	Custom Fields

Managing a settings group

Clicking Manage on any working category opens a real settings screen for that group — every actual setting HCM ships for that category, each with its current value and a way to change it.

Settings come in three tiers, and the tier changes what happens when you save:

• Safe settings (tier 1) — save immediately, no approval needed.
• Sensitive settings (tier 2/3) — saving doesn't apply the change right away. Instead it's held as a pending value until someone with the right authority approves it. Only once approved does the new value actually take effect.

This means you might change a sensitive setting and not see it "stick" immediately — that's expected, not a bug. Check for a pending approval if a setting you changed doesn't seem to have updated.

Country Configuration

A separate screen for turning on Country Packs — bundles of country-specific settings (statutory requirements, tax rules, social security, leave rules, payroll rules, working-time rules, holidays, compliance requirements, and employee ID formats) for a specific country.

• Activate a country once its pack is installed, and its settings become available through the same settings screens as everything else.
• Retire a country to turn it back off.

At the time of writing, only India has a Country Pack installed and available to activate here — this isn't a general "pick any country in the world" list, only whatever packs your tenant actually has installed show up.

Approvals for sensitive settings

If you're the one approving a pending settings change (rather than the one who proposed it), you'll see it come through the normal HCM approvals inbox, the same place any other approval request in HCM shows up.

Known gaps

• Six of the 12 categories aren't built yet: HR Policies, Workflows, Notifications, Integrations, Security, and Custom Fields all still say "Coming soon" — there's no settings screen behind them yet.
• Country Configuration only lists India today, not a general list of every country in the world — more countries appear here as their packs get installed.

Related

• Add your own app-owned roles & permissions