Skip to content

Publication target settings

Each publication target is configured with the following settings.

Setting

Description

Required

Name

Display name for the target

Yes

Output format

Web or PDF

Yes

Condition profile

Which dimension values to include (e.g., Audience: Admin)

No

Variable set

Which variable set to use for token substitution

No

Variable overrides

Per-target value overrides for specific variables

No

Subdomain

Custom subdomain for the published URL

Web only

Custom domain

Custom domain for the published site

Web only

Condition profile

A JSON object mapping dimension names to arrays of values:

{ "Audience": ["Admin"], "Platform": ["Web", "Mobile"] }

Content wrapped in conditional blocks is included only if the block's dimension/value matches the profile.

An empty condition profile (or no profile at all) includes all content regardless of conditions. If you leave the profile blank, every conditional block appears in the output — there is no "exclude everything" default.

Example profiles for common scenarios:

// Admin web docs — only Admin audience, Web platform
{ "Audience": ["Admin"], "Platform": ["Web"] }

// End-user docs — all platforms
{ "Audience": ["End User"], "Platform": ["Web", "Mobile", "Desktop"] }

// Internal docs — multiple audiences, single platform
{ "Audience": ["Admin", "Developer"], "Platform": ["Web"] }

Variable set

Select a variable set from the project's defined sets. All variable tokens in the content resolve to values from this set.

Variable overrides

Key-value pairs that override specific values from the selected variable set. Useful for changing one or two values without creating a separate set — e.g., overriding api_base_url for a staging target.

{
  "api_base_url": "https://staging-api.example.com",
  "support_email": "staging-support@example.com"
}

Variable overrides take precedence over the variable set. If the same key exists in both the set and the overrides, the override value wins. Keys in the override that don't exist in the set are ignored.

Publishing states

State

Description

URL behavior

Published

Site is live and accessible at its URL

Returns site content

Unpublished

Site is offline

URL returns no content

Toggle between states by clicking Publish or Unpublish on the target.


See also

Was this page helpful?