ObjectOSLocalization
Set the tenant-wide timezone, language, country, default currency and fiscal year start that every rendered value inherits.
Localization sets the tenant-level defaults for how ObjectOS interprets time, chooses a message catalog, and renders dates, numbers, and currency. These values are the fallback for the whole workspace — individual users can override their own language in their Account, but the defaults you set here apply to everyone who has not.
Open Setup → Configuration → Localization. The page is split into two sections: Region and Finance.
Region
Region controls how ObjectOS resolves meaning — which timezone anchors relative-time calculations, which locale drives formatting, and which country the deployment reports as its home.
| Setting | Default | Drives |
|---|---|---|
Default timezone | UTC | IANA zone for today() / daysFromNow, analytics date buckets, and rendered datetimes |
Default language | English (US) | BCP-47 locale for message catalogs and number/date formatting |
Default country | US | ISO 3166-1 alpha-2 code (e.g. US, GB, CN) |
Timezone is not cosmetic. It is the anchor for every relative-time expression and for the buckets analytics rolls records into. Changing it shifts what "today" means across the tenant — set it once, deliberately.
Default timezone is a dropdown of IANA zones (UTC, America/New_York,
Asia/Shanghai, and so on). Default language selects the locale whose
message catalog and formatting rules the UI falls back to. Default country
is a free-text field that expects a two-letter ISO code.
Finance
| Setting | Default | Drives |
|---|---|---|
Default currency | none | The ISO 4217 code a currency field uses when it does not declare its own. Leave it unset and such amounts render as plain numbers, with no guessed symbol |
Fiscal year start | January | The first month of the fiscal year — what "this quarter" and "this fiscal year" mean in reports |
Dates, times and numbers follow the language
There is no separate format setting. How a date, a time or a number is
written out, and which day a week starts on, follow Default language
(or the user's own language). ObjectStack 17.7 retired the four format
settings this page used to list — date_format, time_format,
number_format and first_day_of_week — because nothing read them. A
value stored earlier is kept but no longer served; a
PUT /api/settings/localization that names one of them is refused
400 UNKNOWN_KEY for the whole request, the valid keys beside it
included; and the OS_LOCALIZATION_*_FORMAT and
OS_LOCALIZATION_FIRST_DAY_OF_WEEK variables are no longer read. Formats
change only how a value is displayed: timestamps and numbers are stored
in a canonical form either way.
Tenant defaults vs. user overrides
Everything on this page is a tenant default. When a user sets their own
language in Account, that choice wins for that user's session and rendered
UI; users who leave their preference unset inherit the Default language you
configure here. Timezone, country, currency and fiscal-year defaults apply
tenant-wide.
Where to go next
| Task | Page |
|---|---|
| Change branding, feature flags, and other tenant settings | System Settings |
| Configure a user's personal language override | Your profile |
| Set up transactional email delivery | |
| Return to the administration overview | Configure |