---
id: UJ-031
title: Configure white-label domain, email, locale, and modules
actors: [OWNER, ADMIN]
surface: app.zync.is/settings
goal: Make tenant-facing experiences use the tenant's approved brand, domain, language, and delivery configuration.
trigger: Admin opens tenant settings or white-label setup.
preconditions:
  - White-label/tier capability and settings permissions; DNS/provider access where required.
success_state: Settings are persisted, validated, and reflected on future tenant/portal/public surfaces.
source_specs:
  - docs/specs/2026-05-30-white-label-api.md
  - docs/specs/2026-05-31-custom-domain-settings-ui.md
  - docs/specs/2026-05-31-custom-smtp-email-whitelabel.md
  - docs/specs/2026-05-31-hebrew-locale-dates.md
  - docs/specs/2026-05-31-rtl-hebrew-ui.md
  - docs/specs/2026-05-31-dark-light-theme.md
  - docs/specs/2026-05-31-module-management.md
---

## Happy path

1. Admin sets logo, brand color, locale, currency, timezone, RTL/theme preferences, and portal appearance → Zync validates supported values.
2. Admin configures custom domain → Zync provisions/validates provider hostname and exposes DNS/SSL status.
3. Admin configures custom SMTP/from identity → Zync verifies domain/credentials and encrypts secrets.
4. Admin enables/disables modules → dependency/tier rules calculate effective module set.
5. Admin previews tenant app, portal, public pages, and email settings → saves; future surfaces render the effective configuration.

## Alternate and failure paths

- DNS/SSL/SMTP verification fails → retain pending/error status; do not claim active branding/delivery.
- Module dependency or tier violation → block change or force required dependency state.
- Invalid locale/date/RTL combination → show supported correction.

## Permissions and boundaries

- Settings changes are tenant-scoped and audited.
- Custom domain and SMTP setup never exposes provider secrets to ordinary staff or portal users.

## Source specs

- `docs/specs/2026-05-30-white-label-api.md`
- `docs/specs/2026-05-31-custom-domain-settings-ui.md`
- `docs/specs/2026-05-31-custom-smtp-email-whitelabel.md`
- `docs/specs/2026-05-31-hebrew-locale-dates.md`
- `docs/specs/2026-05-31-rtl-hebrew-ui.md`
- `docs/specs/2026-05-31-dark-light-theme.md`
- `docs/specs/2026-05-31-module-management.md`