Site Start Page

When you assign the valid resource ID of a page to the start_page key in your playbook, site visitors will be redirected from the site’s index page at the site URL to the URL of the start page.

start_page key

The start_page key is optional. It’s configured under the site key in a playbook.

Example 1. antora-playbook.yml
site:
  title: Site Title
  url: https://example.org
  start_page: component:module:file-coordinate-of-page.adoc

You can use any page that belongs to a component version as the index page for your site. The start_page key accepts the resource ID of a page as a value. The resource ID must include the component, module, and file coordinates. The version coordinate can be specified if you want to use a specific version of a page instead of the latest version. Alternatively, start_page can be assigned from the CLI.

Use a page’s latest version

To have the start_page key always point to the latest version of the specified page, don’t enter the version coordinate in the resource ID of the page.

Example 2. antora-playbook.yml
site:
  title: Demo Docs Site
  url: https://demo.antora.org
  start_page: component-b::index.adoc

For this example, let’s say that version 2.0 is the latest version of Component B. In this case, https://demo.antora.org/index.html will redirect to https://demo.antora.org/component-b/2.0/index.html.

Use a specific version of a page

If you want the site’s start page to be a specific version of the designated page, include the version coordinate in the resource ID.

Example 3. antora-playbook.yml
site:
  title: Demo Docs Site
  url: https://demo.antora.org
  start_page: 1.0@component-b::index.adoc

In this example, https://demo.antora.org/index.html will redirect to https://demo.antora.org/component-b/1.0/index.html.

To configure a start page for a component version, see Choose a Start Page.