Publishing Targets
Create named publishing configurations to control navigation, page visibility, and site appearance. Publish different versions of your documentation for different audiences.
Publishing targets let you create multiple configurations for your documentation site. Each target can have different navigation, page visibility, and home page settings. Use targets to publish separate sites for different audiences from a single content source.
What Are Publishing Targets?
A publishing target is a named configuration that controls.
Use Cases
Documentation vs Marketing
Separate technical docs from marketing pages
Internal vs External
Publish different content for internal teams and external customers
Product Variants
Create documentation for different product editions
Audience Segmentation
Target developers, administrators, and end users
Creating a Target
Target Properties
| Property | Description |
|---|---|
| ID | Unique identifier (auto-generated with 'pt_' prefix) |
| Name | Display name shown in the wizard |
| Description | Optional description of the target's purpose |
| Show Top Bar | Whether to include the top navigation menu |
| Show Footer | Whether to include the site footer |
| Use Marketing Home | Use marketing sections instead of knowledge graph |
Assigning Pages to Targets
Each page can be assigned to one or more publishing targets.
Target Selection in the Wizard
When publishing with targets enabled.
Navigation Per Target
Each target can have different navigation settings.
| Setting | Enabled | Disabled |
|---|---|---|
| Top Bar | Shows the top menu with site name and navigation items | Hides the top bar for minimal interfaces |
| Footer | Shows the footer with link groups and copyright | Hides the footer for embedded or compact views |
Marketing vs Documentation
Example: Docs and Marketing Targets
A common pattern is two targets.
| Setting | Documentation Target | Marketing Target |
|---|---|---|
| Show Top Bar | Yes | Yes |
| Show Footer | Yes | Yes |
| Use Marketing Home | No | Yes |
| Assigned Pages | Guides, Reference, API docs | Home, Features, Pricing, About |