Landing Page

The landing page is the first thing readers see when they open your docs site's main URL. It welcomes them, lets them search, and points them to your most useful content. You can use the built-in landing page, pick a template, or have AI design one for you.

#

What the built-in landing page shows

  • Your title. Set it in Settings > Theme & Customization > Add HomePage Title. If it's empty, readers see "How can we help?".
  • A search bar in the middle of the page, so readers can search all your docs right away.
  • Featured cards for your three most-viewed top-level pages. Cards appear only when at least three top-level pages have a feature image.
  • Browse by topic, a list of all your top-level pages.

Title (1).png

#

Turn the landing page on or off

The landing page is on by default.

  1. Open the collection and click Settings in the left sidebar.
  2. Open Theme & Customization.
  3. Under Visible Components, turn Homepage on or off.
  4. Click Save.
#

Pick a template

The Templates tab sets the layout of your public site and its landing page.

  1. Go to Settings > Templates.
  2. Click a template card. Each card has a description and a preview.
  3. Click Save.
Template Collection type Layout
Default Theme Docs and API Fixed sidebar and sticky table of contents, made for long-form reading.
Hover Sidebar Docs and API Navigation and table of contents appear on hover, for a cleaner reading view.
Blog Featured Layout Blog A featured post at the top, then a list of recent articles.
Blog Grid Layout Blog Large cards with tags and dates.

To adjust colors and fonts for the template, click Customize Theme.

#

Build a landing page with AI

Describe the home page you want and AI builds it for you.

  1. In Settings > Templates, find the AI Generated Theme card.
  2. Click Build with AI.
  3. In the chat, describe your page. For example: "A hero section with our tagline, three cards for Getting Started, API Reference and Guides, and a contact section."
  4. Keep chatting to refine the design. Each result is saved as a version.
  5. Click Back to Templates when you're done.
#

Manage AI versions

Click View AI Generation History to see Previous Generations. For each version you can:

  • Customize: change text, images and links without generating again.
  • Preview: see the page full size.
  • Publish: make this version your live landing page. The live version is marked Active.
  • Delete: remove versions you don't need.

Make sure the AI Generated Theme card is selected, then click Save.

#

Tips

  • Add feature images to your key top-level pages so the built-in landing page shows featured cards.
  • Blog collections don't use the built-in landing page. Use a blog template, or build a custom landing page with AI.
  • Keep your landing page links up to date when you rename pages. Redirects catch old links, but direct links are faster.
Built with DocStar