Design and navigate a Site

Create a consistent branded journey from the first academy page to the learner's course. Use the Default visual editor for templates and page blocks, or Custom mode for an assistant-built experience.

Choose a starting layout

1. Open the Site and keep Default selected.
2. In the right-hand Layout tab, choose Template: Courses & documentation, Academy, Knowledge Base, or Developer docs.
3. Expand Introduction and write a clear heading and description.
4. Review the preview and choose Save.

Templates provide a starting arrangement. Your selected content and brand settings remain part of the Site.

Arrange page blocks

1. In Layout, use Add block to choose the section you need.
2. Expand the new block and fill its fields.
3. Use Move block up and Move block down to arrange the page.
4. Use Remove block for a block you no longer need.
5. Save and review the complete page.

Use Curate Site content to prepare the courses, paths, and documentation behind those blocks.

Apply your brand

1. Open Design → Branding and upload the Logo and Favicon.
2. Under Colors, choose a palette: Editorial, Clean, Bold, Academic, Warm, Midnight, or Custom.
3. Adjust Primary, Background, Text, Card, and primary/secondary button text colors using the pickers or hex fields.
4. Expand Typography to choose heading and body fonts.
5. Expand Layout to choose corner radius and spacing.
6. Save and inspect headings, body text, cards, and buttons together.

For a consistent signed-in experience, enable Theme dashboard and courses under Learning experience. Set the light and dark palettes, or use Copy brand palette for the selected mode, then review the contrast checks. These settings apply when learners enter through the verified workspace or Site domain. Choose Learner experience from Pages to preview the result.

Configure the top bar and navigation

1. In Layout, expand Top bar & navigation.
2. Choose whether to Keep navigation visible, show Search, show the Name beside logo, and display Section tabs.
3. Adjust the top bar height.
4. Add Top links with a label and destination, such as an internal /docs route or an HTTPS destination. Reorder or remove links as needed.
5. Enable the primary button, enter its label and destination, and choose its Button placement: top bar or top of the left sidebar.
6. Use Choose section tabs to curate section destinations and their order.
7. Save and follow each destination in the preview.

Use up to eight top links to keep the primary navigation focused. Match labels to the task visitors want to complete, such as “Learn,” “Guides,” or “API reference.”

Tune spacing and page actions

1. Expand Padding & spacing.
2. Adjust side padding, top/bottom padding, space between sections, and navigation width. Use Reset spacing to return to the starting values.
3. Expand Page actions and choose the reader tools to offer: copy as Markdown, copy an LLM prompt, download Markdown, and copy the page link.
4. Review the page at a narrow and wide browser width. Spacing scales down for smaller screens.

Add a standalone page

1. Return to Pages in the left sidebar.
2. Choose Add page and enter the page title in the prompt.
3. Open the new page from Pages. It receives its own page route and a top-navigation link.
4. Use the Site's AI assistant to describe the page content you want, naming the selected page and the desired visitor action.
5. Review the generated page, save the draft, and include it in your next publication.

To remove a standalone page, use its remove control in Pages and confirm the named page. Review navigation afterward. Built-in Home, Course page, Docs, and learner pages have their own content and configuration controls.

Work in Custom mode

1. Save the current draft.
2. Choose Custom, read the mode description, and confirm the switch.
3. Describe the page structure, content, and interactions in the Site assistant. Use concrete instructions, for example: “Create a customer onboarding homepage with a welcome message, three learning steps, and links to our selected guides.”
4. Review the generated preview, then ask for focused refinements.
5. Save and publish after reviewing the complete visitor journey.

Default layout settings are retained for Default mode; brand and selected content are shared across modes. Review the mode switch and preview before publishing a change of presentation.

Continue with API reference and visitor assistant or access and onboarding.