Document on-page feedback logging for self-hosted deployments (#4504)

Co-authored-by: fern-support <support@buildwithfern.com>
Co-authored-by: bot_apk <apk@cognition.ai>
Co-authored-by: fern-api[bot] <115122769+fern-api[bot]@users.noreply.github.com>
Co-authored-by: Devin Logan <devinannlogan@gmail.com>

Author: 5 people

fern/products/docs/pages/changelog/2026-03-23.mdx

@@ -0,0 +1,9 @@
+---
+tags: ["self-hosted"]
+---
+
+## On-page feedback logging for self-hosted deployments
+
+Self-hosted deployments now log [on-page feedback](/learn/docs/user-feedback) events as structured JSON with the `[fern-docs-feedback]` prefix. Filter your container logs to capture user feedback, including thumbs up/down votes and written messages.
+
+<Button intent="none" outlined rightIcon="arrow-right" href="/learn/docs/self-hosted/set-up#on-page-feedback">Read the docs</Button>

fern/products/docs/pages/customization/user-feedback.mdx

@@ -29,6 +29,10 @@ By default, every Markdown page of your docs contains a feedback component at th
 
 You can also disable this feature for [individual pages](/learn/docs/configuration/page-level-settings#on-page-feedback) or [all pages](/learn/docs/configuration/site-level-settings#layouthide-feedback).
 
+<Info title="Self-hosted user feedback">
+In [self-hosted](/learn/docs/self-hosted/overview) deployments, feedback events are logged as structured JSON to the container's stdout. See [On-page feedback](/learn/docs/self-hosted/set-up#on-page-feedback) for details.
+</Info>
+
 ## Edit this page
 
 Allow users to suggest changes to the current page directly from your docs. There are two modes for this feature:
@@ -51,4 +55,4 @@ You can configure this feature — including whether the button links directly t
 
 <Note>
 This feature works in preview links but does not work in local development.
-</Note>
+</Note>

fern/products/docs/pages/enterprise/self-hosted-set-up.mdx

@@ -168,6 +168,37 @@ ENV CORS_PROXY_ALLOWED_DOMAINS="plantstore.dev,partner-api.example.com"
 |---|---|---|
 | `ENABLE_JAEGER` | Set to `true` to start [Jaeger](https://www.jaegertracing.io/) for distributed tracing. The Jaeger UI is available on port 16686. | `false` |
 
+## On-page feedback
+
+In self-hosted mode, [on-page feedback](/learn/docs/user-feedback) events are emitted as structured JSON logs to the container's stdout, prefixed with `[fern-docs-feedback]`. You can filter for these in your logging infrastructure:
+
+```bash
+docker logs <container-id> 2>&1 | grep "\[fern-docs-feedback\]"
+```
+
+Each log line contains an event name, a timestamp, and a set of properties:
+
+```json
+[fern-docs-feedback] {"event":"feedback_submitted","timestamp":"2026-01-15T12:34:56.789Z","properties":{"satisfied":true,"message":"Great docs!","email":"user@example.com","type":"on-page-feedback"}}
+```
+
+### Tracked events
+
+| Event | Description |
+|---|---|
+| `feedback_voted` | A user clicked the thumbs up or thumbs down button. |
+| `feedback_submitted` | A user submitted written feedback via the feedback form. |
+| `code_block_feedback_submitted` | A user reported an issue with a code example. |
+
+### Properties
+
+| Property | Description |
+|---|---|
+| `satisfied` | `true` for thumbs up, `false` for thumbs down. |
+| `message` | The user's written feedback message (present in `feedback_submitted` and `code_block_feedback_submitted` events). |
+| `email` | The user's email address, if provided. |
+| `type` | The feedback source, such as `on-page-feedback`. |
+
 ## Additional configuration
 
 The following sections cover optional configurations for specific deployment scenarios.

fern/products/docs/pages/enterprise/self-hosted.mdx

@@ -54,7 +54,7 @@ PDF export and **offline AI chat functionality** for self-hosted deployments are
 | [llms.txt](/learn/docs/ai-features/llms-txt) | Yes |
 | [Navigation and sidebar](/learn/docs/configuration/navigation) | Yes |
 | [OAuth](/learn/docs/authentication/setup/oauth) | No |
-| [On-page feedback](/learn/docs/user-feedback) | No |
+| [On-page feedback](/learn/docs/self-hosted/set-up#on-page-feedback) | Yes |
 | [Page-level access control](/learn/docs/configuration/page-level-settings) | Yes |
 | [Password protection](/learn/docs/self-hosted/authentication) | Yes |
 | [RBAC](/learn/docs/authentication/features/rbac) | No |
@@ -100,7 +100,7 @@ sequenceDiagram
 
 ## Monitoring and health checks
 
-The self-hosted container includes [health check endpoints](./health-check-endpoints) on port 8081 for Kubernetes and Helm deployments.                                                                                                                                                                                                                                                                
+The self-hosted container includes [health check endpoints](./health-check-endpoints) on port 8081 for Kubernetes and Helm deployments.