Skip to content

Add third-party tools integration docs and embed snippet example #4534

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
devalog merged 4 commits into from
Mar 25, 2026
Merged

Add third-party tools integration docs and embed snippet example #4534

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
7e47251
Add third-party tools integration documentation to integrations overview
fern-support Mar 25, 2026
164d913
Add embed snippet example and flesh out custom JS cross-reference
fern-support Mar 25, 2026
6b0e376
Remove natively supported tools from custom JS list, use Hotjar examp…
fern-support Mar 25, 2026
92878aa
clarify text and reduce repetition
devalog Mar 25, 2026
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
6 changes: 3 additions & 3 deletions fern/products/docs/pages/component-library/custom-components/custom-css-js.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -243,8 +243,8 @@ js:

### Common use cases

- Integrate with [third-party platforms](/docs/integrations/overview) that Fern doesn't natively support
- Implement custom search (also requires [your Algolia credentials](/docs/customization/search))
- Insert scripts and widgets
- **Third-party integrations:** For tools not natively supported in `docs.yml`, add analytics, session recording, support widgets, or tag managers by pasting their embed snippets into your custom JS file. See [Integrating third-party tools](/learn/docs/integrations/overview#connect-other-integrations-via-custom-javascript) for supported tools and examples.
- **Custom search:** Implement custom search (also requires [your Algolia credentials](/docs/customization/search))
- **Scripts and widgets:** Insert any client-side scripts or embeddable widgets


17 changes: 15 additions & 2 deletions fern/products/docs/pages/integrations/overview.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -91,8 +91,21 @@ are available during the workflow run.
</Note>


## Connect other integrations
## Connect other integrations via custom JavaScript

<Markdown src="/snippets/enterprise-plan.mdx"/>

If you want to integrate with a third-party analytics or support platforms that Fern doesn't directly support, you can do so [using custom JS](/docs/customization/custom-css-js#custom-javascript).
You can integrate third-party tools that Fern doesn't natively support in `docs.yml` using [custom JavaScript](/docs/customization/custom-css-js#custom-javascript), as long as they support HTML tag-based installation. This works with tools like:

- **Analytics:** Amplitude, Heap, Plausible
- **Session recording:** Hotjar, LogRocket, Microsoft Clarity
- **Support and chat:** Zendesk, Crisp, Drift
- **Tag managers:** Adobe Launch, Tealium

Paste the vendor's `<script>` snippet into a custom JS file and reference it in your `docs.yml`:

<CodeBlock title="docs.yml">
```yaml
js: ./custom.js
```
</CodeBlock>
Loading