---
seo:
    title: "Gathering Feedback"
    description: "How to gather and manage user feedback within the portal."
llm_context: "The portal supports the ability to gather feedback from users, and a light-weight mechanism for managing it."
category: "reference"
related:
    - "/portal"
---

## Customer Feedback Loop

This portal supports the ability for both authenticated and anonymous users to provide feedback on the content of the portal.

This is an optional feature that can be enabled by setting the `feedback` attribute in the `portal.yaml` file at the root of the `docs/` directory.

```yaml
feedback:
    portal: true
    offline: "Alternatively, contact your account manager or support at feedback@fixspec.com."
```

```jsonSchema protocol=config version=portal-yaml-schema def=feedback
{
    "type": "object",
    "additionalProperties": false,
    "description": "Customer feedback configuration.",
    "properties": {
        "portal": {
            "type": "boolean",
            "description": "Enable in-portal feedback mechanism"
        },
        "offline": {
            "type": "string",
            "description": "Text displayed when feedback system is unavailable"
        }
    }
}
```

The functionality is globally enabled by setting `feedback.portal` to `true`.

When enabled, any user is able to provide feedback on the content of a given page by using the feedback button that appears in the footer, and completing the modal that appears.

![Figure: Portal feedback button and widget.](https://docs.fixspec.com/api/docs/image/feedback_assets.png)

If the `feedback.offline` attribute is set to a non-empty string, then users can also be signposted towards other support options you may offer, such as a third-party ticketing system, email or phone support.

Once feedback has been submitted, administrative users have the ability to view, add notes and change the status of tickets via the feedback management page in the portal.

Note that there is currently no mechanism to chat in real time with users via the portal; the feedback mechanism is intended for asynchronous, one-way communication only.

### Frequently Asked Questions

:::faqs
::faq[Can users see a reply to their feedback?]{#faq_portal_feedback_replies}
No — there's no mechanism for users to see notes or replies within the portal itself. If you want to close the loop with a user, you'll need to follow up through your own channels, such as email.
::
::faq[Is feedback tied to a specific page?]{#faq_portal_feedback_page_context}
Yes — feedback is always submitted in the context of the page the user was viewing, so administrators can see exactly which content prompted it.
::
:::
