Operator guideEN

Domains / Form

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

How to use this guide

Start with the main guide

Follow the explanation and examples first. Extra definitions and formulas are available below when you need them.

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 the selected domain type.

Type-specific behavior

  • Every new domain needs a URL, a domain type, and an initial active-state value.
  • Zone-domain types unlock SendGrid Email From, the main settings toggles, registration rules by country, include countries, payment method rules, withdraw method rules, leads and tags, registration country allow or deny lists, and country-swap rules.
  • Non-zone domain types keep only the Redirect With Path toggle from the settings block.

Advanced settings blocks

  • Include Countries stores the country allowlist for a zone domain.
  • Included and excluded deposit methods store payment method ids that should be explicitly allowed or blocked for the domain.
  • Included and excluded withdraw methods use the withdraw-capable payment method list.
  • Leads Only marks the domain as lead-only. Include and exclude tags store tag names used by the domain settings.
  • Registration allowed and forbidden countries store country-code lists for registration access.
  • Country swap rules map one incoming country to a target country and optional city value.

Important caveats

  • URL uniqueness is enforced when the record is created.
  • 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.
  • Country swap rows are also kept locally and are copied into settings.countrySwap at submit time.
More details

Definitions and formulas

Open only the section you need. The relevant section opens automatically when you request help for a specific item on screen.

Calculations6 topicsOpen details

Zone-type branching

Logic
The form loads domain types from `GET /api/admin/get-domain-types`., Domain types whose returned `code` starts with `ZONE` are treated as zone-domain types., Zone-domain types reveal `SendGrid Email From`, the main settings booleans, registration-rule cards, include countries, payment method rules, withdraw method rules, leads and tags, registration country allow or deny lists, and country-swap rules., Non-zone domain types render only the `Redirect With Path` checkbox from the settings block.

Create defaults

Logic
Initial defaults are `domainType: 1`, `isActive: 0`, all settings booleans `false`, `registrationConfigs: []`, `allowedCountries: []`, method allow/deny arrays `[]`, registration country allow/deny arrays `[]`, `countrySwap: {}`, `leadsOnly: false`, `includeTags: []`, and `excludeTags: []`.

Registration rules local buffer

Logic
Registration rules by country are stored in local component state as `configuredRegistrationCountries`., `Add registration rule by country` appends a blank `{ country: '', time: [] }` card., `Add Time Range` appends a `{ deviceType: 'mobile', from: '', to: '' }` row inside the selected card., Submit copies the local array into `payload.settings.registrationConfigs` just before the create or update request.

Country swap local buffer

Logic
Country swap rows are stored in local component state as `{ fromCountry, toCountry, cities }`., `Add Swap Rule` appends a blank row., Submit reduces rows with a non-empty `fromCountry` into `payload.settings.countrySwap`., Each saved map entry uses the source country as the key and stores `{ country: toCountry, city: cities }`.

Option list value shapes

Logic
Country editors store country codes., Payment method editors store payment method ids as strings., Withdraw method editors use only payment methods marked as withdrawal-capable., Tag editors store tag names.

Cancel and success navigation

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.
Fields30 topicsOpen details

Url

Domain URL stored for the new record.

Group
identity
Data Type
string

Domain type

Type selector that drives which settings blocks become relevant.

Group
identity
Data Type
enum

isActive

Initial active-state selection for the new domain record.

Group
status
Data Type
enum

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`.

Demo Mode Only

Restricts the domain to demo-only usage.

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

Footer Off

Disables footer rendering for the domain.

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

System Emails Off

Disables system-generated emails for the domain.

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

Index Mode Off

Disables index mode for the domain.

Group
settings
Data Type
boolean
Caveats
Visible only for zone-domain types., The UI notes that this can also cause 403 behavior for a non-whitelisted URL parameter.

Login Off

Disables login on the domain.

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

Hide Extended Profile Details

Hides extended profile detail fields for users on the domain.

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

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.

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.

Included Deposit Methods

Payment method ids explicitly included for deposit usage on this domain.

Group
payment-method-settings
Data Type
string-list
Caveats
Visible only for zone-domain types., Options come from the payment-method list and are stored as string ids.

Excluded Deposit Methods

Payment method ids explicitly excluded from deposit usage on this domain.

Group
payment-method-settings
Data Type
string-list
Caveats
Visible only for zone-domain types., Options come from the payment-method list and are stored as string ids.

Included Withdraw Methods

Withdraw-capable payment method ids explicitly included for this domain.

Group
payment-method-settings
Data Type
string-list
Caveats
Visible only for zone-domain types., Options are limited to payment methods marked as withdrawal-capable.

Excluded Withdraw Methods

Withdraw-capable payment method ids explicitly excluded for this domain.

Group
payment-method-settings
Data Type
string-list
Caveats
Visible only for zone-domain types., Options are limited to payment methods marked as withdrawal-capable.

Leads Only

Marks the domain settings as lead-only.

Group
leads-tags
Data Type
boolean
Caveats
Visible only for zone-domain types.

Include Tags

Tag names explicitly included by the domain settings.

Group
leads-tags
Data Type
string-list
Caveats
Visible only for zone-domain types., Options come from the tag list and are stored as tag names.

Exclude Tags

Tag names explicitly excluded by the domain settings.

Group
leads-tags
Data Type
string-list
Caveats
Visible only for zone-domain types., Options come from the tag list and are stored as tag names.

Registration Allowed Countries

Country codes explicitly allowed for registration on this domain.

Group
registration-access
Data Type
string-list
Caveats
Visible only for zone-domain types.

Registration Forbidden Countries

Country codes explicitly forbidden for registration on this domain.

Group
registration-access
Data Type
string-list
Caveats
Visible only for zone-domain types.

Country

Country code targeted by one registration-rule card.

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

Device Type

Device type for one registration-time window.

Group
registration-configs
Data Type
enum

From

Start time for one device-specific registration window.

Group
registration-configs
Data Type
time

To

End time for one device-specific registration window.

Group
registration-configs
Data Type
time

Registration Settings for Country

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

Group
registration-configs
Data Type
object-list

Country Swap

Map of incoming country codes to replacement country and optional city values.

Group
country-swap
Data Type
object-map
Caveats
Visible only for zone-domain types., Rows are kept in local form state and copied into `settings.countrySwap` on submit.

Swap Country

Incoming country code that should be swapped.

Group
country-swap
Data Type
enum

Target Country

Replacement country code saved for the swap rule.

Group
country-swap
Data Type
enum

City

Optional city value saved with the swap rule.

Group
country-swap
Data Type
string
More help

Related pages

Domains

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

Domains / Detail

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

Domains / List

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

Affiliate Deals / Form

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

Affiliate Payment Settings / Form

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

Auto Tags Manager / Create

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