|
| 1 | +## Navbar dropdown menus |
| 2 | + |
| 3 | +Organize multiple related links in your navbar with dropdown menus. This new navbar link type allows you to group resources, tools, or external links under a single dropdown button, keeping your header clean while providing easy access to multiple destinations. |
| 4 | + |
| 5 | +```yaml title="docs.yml" |
| 6 | +navbar-links: |
| 7 | + - type: dropdown |
| 8 | + text: Resources |
| 9 | + icon: fa-solid fa-seedling |
| 10 | + links: |
| 11 | + - text: Plant database |
| 12 | + href: https://example.com/plants |
| 13 | + icon: fa-regular fa-leaf |
| 14 | + - text: Growing guides |
| 15 | + href: https://example.com/guides |
| 16 | + icon: fa-regular fa-book |
| 17 | + - text: Community forum |
| 18 | + href: https://example.com/forum |
| 19 | + icon: fa-regular fa-comments |
| 20 | +``` |
| 21 | +
|
| 22 | +Each dropdown link supports: |
| 23 | +- **text**: The display text for the link |
| 24 | +- **href**: The destination URL |
| 25 | +- **icon**: Optional Font Awesome icon or custom image that displays to the left of the text |
| 26 | +- **rightIcon**: Optional icon that displays to the right of the text |
| 27 | +- **rounded**: Optional boolean to apply fully rounded borders |
| 28 | +
|
| 29 | +Learn more in the [navbar links configuration](/learn/docs/configuration/what-is-docs-yml#navbar-links-configuration) documentation. |
| 30 | +
|
| 31 | +## API Explorer direct requests |
| 32 | +
|
| 33 | +Bypass the Fern proxy and send API Explorer requests directly to your API with the new `disable-explorer-proxy` setting. This is useful when you want to test your API's CORS configuration or need direct communication between the documentation site and your API. |
| 34 | + |
| 35 | +```yaml title="docs.yml" |
| 36 | +settings: |
| 37 | + disable-explorer-proxy: true |
| 38 | +``` |
| 39 | + |
| 40 | +<Warning> |
| 41 | +When this feature is enabled, your API must have Cross-Origin Resource Sharing (CORS) enabled to allow requests from the documentation domain. |
| 42 | +</Warning> |
| 43 | + |
| 44 | +By default, API Explorer requests are proxied through Fern's servers to avoid CORS issues. With this setting enabled, requests go directly from the user's browser to your API, which can be helpful for testing CORS policies or debugging authentication flows. |
| 45 | + |
| 46 | +Learn more in the [docs.yml reference](/learn/docs/configuration/what-is-docs-yml#settings-configuration) documentation. |
0 commit comments