Skip to content

docs: add target property for links in navigation #2025

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 4 commits into from
Nov 16, 2025
Merged

docs: add target property for links in navigation #2025

Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
38e269e
docs: add target property for links in navigation
devin-ai-integration[bot] Nov 14, 2025
535e55f
fix: remove time-relative term from changelog
devin-ai-integration[bot] Nov 14, 2025
aacdfb4
refine target explanation
devalog Nov 14, 2025
0738207
remove local file
devalog Nov 14, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 11 additions & 0 deletions fern/products/docs/pages/changelog/2025-11-14.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
## Link target property

You can now specify where links open using the `target` property. This applies to product links, tab links, page links, and navbar links. Options are `_blank` (new tab), `_self` (same tab, default), `_parent`, and `_top`.
Copy link
Contributor

@github-actions github-actions bot Nov 14, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ [vale] reported by reviewdog 🐶
[FernStyles.Current] Avoid time-relative terms like 'now' that become outdated


```yaml title="docs.yml"
navbar-links:
- type: filled
text: Dashboard
href: https://dashboard.example.com
target: _blank
```
4 changes: 4 additions & 0 deletions fern/products/docs/pages/customization/site-level-settings.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -293,6 +293,10 @@ navbar-links:
By default, the `rightIcon` for a `filled` button is set to `arrow-right`.
</ParamField>

<ParamField path="target" type="string" required={false} toc={true}>
Specifies where to open the linked URL. Options are `_blank` (new tab), `_self` (same tab, default), `_parent`, and `_top`.
</ParamField>

<ParamField path="links" type="list of objects" required={false} toc={true}>
Items to display in the dropdown menu when `type` is set to `dropdown`.
</ParamField>
Expand Down
13 changes: 13 additions & 0 deletions fern/products/docs/pages/navigation/overview.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -281,6 +281,19 @@ navigation:
<img src="./external-link.png" alt="An external link within navigation" />
</Frame>

### Link target

Specify where the link opens using the `target` property. Options are `_blank` (new tab), `_self` (same tab, default), `_parent`, and `_top`.

```yaml title="docs.yml"
navigation:
- section: Home
contents:
- link: Our YouTube channel
href: https://www.youtube.com/
target: _blank
```

## Tabs

You can add tabs to group sections of content together. Tabs can contain different layouts and navigation structures, and you can use tab variants to show different content variations within a single tab. For more information, see [Tabs and tab variants](/learn/docs/configuration/tabs).
Expand Down
3 changes: 2 additions & 1 deletion fern/products/docs/pages/navigation/products.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -125,6 +125,7 @@ products:
href: https://dashboard.example.com # External product
icon: "<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='currentColor'><path d='M12 2L2 7v10c0 5.55 3.84 10.74 9 12 5.16-1.26 9-6.45 9-12V7l-10-5z'/></svg>" # Inline SVG
subtitle: Product C subtitle
target: _blank # Optional: _blank, _self, _parent, or _top
```
</CodeBlock>

Expand Down Expand Up @@ -345,4 +346,4 @@ The dropdown menus for product and version selectors can be customized using the
<img src="webflow-version-selector.avif" alt="Example of a styled version selector" />
</Frame>
</Tab>
</Tabs>
</Tabs>
1 change: 1 addition & 0 deletions fern/products/docs/pages/navigation/tabs.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -24,6 +24,7 @@ tabs:
display-name: GitHub
icon: brands github # Font Awesome icon
href: https://github.com/fern-api/fern
target: _blank # Optional: _blank, _self, _parent, or _top

navigation:
- tab: api
Expand Down
Loading