Skip to content

Commit 2378db7

Browse files
docs: add section about site-level landing page to products documentation (#2909)
Co-authored-by: fern-support <support@buildwithfern.com> Co-authored-by: Fern Support <info@buildwithfern.com>
1 parent 1b0d8e4 commit 2378db7

File tree

1 file changed

+28
-1
lines changed

1 file changed

+28
-1
lines changed

fern/products/docs/pages/navigation/products.mdx

Lines changed: 28 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -143,6 +143,33 @@ If your `docs.yml` file includes a `navigation` field or a `tabs` field, be sure
143143
</Step>
144144
</Steps>
145145

146+
### Add a site-level landing page
147+
148+
You can add a landing page that appears at the root of your documentation site, independent of any product. This is useful when you want users to see an introductory page before selecting a product.
149+
150+
Configure the `landing-page` property in your `docs.yml`:
151+
152+
<CodeBlock title="docs.yml">
153+
```yaml
154+
landing-page:
155+
page: Welcome
156+
path: ./pages/welcome.mdx
157+
slug: /welcome # optional
158+
159+
products:
160+
- display-name: Product A
161+
path: ./products/product-a.yml
162+
- display-name: Product B
163+
path: ./products/product-b.yml
164+
```
165+
</CodeBlock>
166+
167+
The landing page is not linked to any product and will be accessible at the root URL (or the specified slug) of your documentation site.
168+
169+
<Note>
170+
For detailed configuration options, see the [landing page configuration reference](/learn/docs/configuration/site-level-settings#landing-page-configuration).
171+
</Note>
172+
146173
### Add versioning to your products
147174

148175
You can optionally add versions to your internal products. Versioned and unversioned products can live next to each other in your site. Versions are not supported for external products.
@@ -350,4 +377,4 @@ The dropdown menus for product and version selectors can be customized using the
350377
<img src="webflow-version-selector.avif" alt="Example of a styled version selector" />
351378
</Frame>
352379
</Tab>
353-
</Tabs>
380+
</Tabs>

0 commit comments

Comments
 (0)