Operator guideENdomainsform

Domains / Form

Create-domain workflow for a new domain record, including type-specific settings, allowlists, and registration configuration.

Reader view

Clean portal guidance

This page keeps the operator explanation, field and action descriptions, and screenshots visible without exposing repo paths, raw sidecars, or editorial-only implementation details.

Narrative content

Page body

What this form does

Use this form to create a new domain record. The form starts with the core domain identity and then reveals different settings depending on whether the selected domain type is treated by FE as a zone type.

Type-specific behavior

  • Every new domain needs a URL, a domain type, and an initial active-state value.
  • FE treats domain types whose backend code starts with ZONE as zone-domain types.
  • Zone-domain types unlock SendGrid Email From, the main settings toggles, registration rules by country, and the include-countries editor.
  • Non-zone domain types keep only the Redirect With Path toggle from the settings block.

Important caveats

  • URL uniqueness is enforced by the backend create flow.
  • The create form is for a new record only. Editing an existing domain happens in the detail workspace.
  • Cancel and successful Create both use router.back(), so the return destination is the previous page rather than a hardcoded domains index route.
  • Registration rules by country are kept in local component state and are copied into settings.registrationConfigs only at submit time.
Calculation notes

Calculations

calculation

Zone-type branching

Verification
verified_backend
Logic
FE loads domain types from `GET /api/admin/get-domain-types`., Domain types whose backend `code` starts with `ZONE` are treated as zone-domain types., Zone-domain types reveal `SendGrid Email From`, the main settings booleans, registration-rule cards, and the include-countries editor., Non-zone domain types render only the `Redirect With Path` checkbox from the settings block.
calculation

Create defaults

Verification
verified_fe_only
Logic
Initial defaults are `domainType: 1`, `isActive: 0`, all settings booleans `false`, `registrationConfigs: []`, and `allowedCountries: []`.
calculation

Registration rules local buffer

Verification
verified_fe_only
Logic
Registration rules by country are stored in local component state as `configuredRegistrationCountries`., `Add registration rule by country` appends a blank `{ country: '', time: [] }` card., Submit copies that local array into `payload.settings.registrationConfigs` just before the create request.
calculation

Cancel and success navigation

Verification
verified_fe_only
Logic
`Cancel` calls `router.back()`., Successful create also calls `router.back()` after reset and success toast., The destination therefore depends on the previous browser history entry, not on a hardcoded route.
Field dictionary

Fields

field

Url

Domain URL stored for the new record.

Group
identity
Data Type
string
field

Domain type

Type selector that drives which settings blocks become relevant.

Group
identity
Data Type
enum
field

isActive

Initial active-state selection for the new domain record.

Group
status
Data Type
enum
field

SendGrid Email From

Sender address field used only for domain types that support zone-level email settings.

Group
zone-settings
Data Type
string
Caveats
Visible only when the selected domain type code starts with `ZONE`.
field

Demo Mode Only

Restricts the domain to demo-only usage.

Group
settings
Data Type
boolean
Caveats
Visible only for zone-domain types.
field

Footer Off

Disables footer rendering for the domain.

Group
settings
Data Type
boolean
Caveats
Visible only for zone-domain types.
field

System Emails Off

Disables system-generated emails for the domain.

Group
settings
Data Type
boolean
Caveats
Visible only for zone-domain types.
field

Index Mode Off

Disables index mode for the domain.

Group
settings
Data Type
boolean
Caveats
Visible only for zone-domain types.
field

Login Off

Disables login on the domain.

Group
settings
Data Type
boolean
Caveats
Visible only for zone-domain types.
field

Redirect With Path

Enables redirect-with-path behavior for non-zone domain types.

Group
settings
Data Type
boolean
Caveats
This is the only settings checkbox rendered for non-zone domain types.
field

Include Countries

Country allowlist for domain types that use zone settings.

Group
zone-settings
Data Type
string-list
Caveats
Visible only for zone-domain types.
field

Country

Country code targeted by one registration-rule card.

Group
registration-configs
Data Type
enum
Caveats
Visible only after `Add registration rule by country`.
field

Device Type

Device type for one registration-time window.

Group
registration-configs
Data Type
enum
field

From

Start time for one device-specific registration window.

Group
registration-configs
Data Type
time
field

To

End time for one device-specific registration window.

Group
registration-configs
Data Type
time
field

Registration Settings for Country

Local country-card buffer that becomes `settings.registrationConfigs` on submit.

Group
registration-configs
Data Type
object-list
Operational notes

Notes

item

The backend create flow rejects duplicate domain URLs.

item

Domain type metadata is backend-owned. FE classifies zone-domain types by checking whether the backend `code` starts with `ZONE`.

item

Registration-rule cards live in local component state as `configuredRegistrationCountries` and are copied into `settings.registrationConfigs` only during submit.

item

The `Include Countries` editor writes into `settings.allowedCountries`, not into a top-level domain field.

item

Both successful create and `Cancel` use `router.back()` instead of a hardcoded domains index route.

Related references

Related pages

pageDomains

Operator documentation for domain inventory, domain creation, edit workspace, and activation rules.

pageDomains / Detail

Saved-domain workspace for editing one domain record and its type-specific settings.

pageDomains / List

Domain inventory with create navigation, edit entrypoints, and direct active or disabled toggling from the grid.

pageAffiliate Deals / Form

Create and edit form for affiliate deals, including PID, date window, commercial terms, and responsible person.

pageAffiliate Payment Settings / Form

Create and edit form for one affiliate payment-setting record, with visible PID targeting, minimum deposit threshold, and active-state control.

pageAuto Tags Manager / Create

Full rule-builder for a new automatic tagging rule, including tag actions, coupon actions, KPI field selection, and draft impact estimation.