# Track feedback

## Overview

Users can provide valuable feedback on Instruqt tracks by rating their experience on a scale from very unhappy to very happy. <br>

<figure><img src="/files/o98w7W4ABLNSXJ4ZG43W" alt=""><figcaption><p>Happiness rating  scale</p></figcaption></figure>

\
After rating it's also possible to add written feedback.&#x20;

<figure><img src="/files/iyWKgezQLFtEZqfqJeZ1" alt=""><figcaption><p>Written feedback</p></figcaption></figure>

\
\
Track authors can configure feedback settings to best fit their needs. \
By default, the feedback option appears at the end of the track, after all challenges are completed.&#x20;

Alternatively, authors can enable a *persistent feedback tab*, allowing users to share feedback during any challenge. For cases where feedback isn’t needed, this option can also be disabled entirely.

<figure><img src="/files/hkRjSOHi0eebVwa4DrxK" alt=""><figcaption><p>Persistent feedback tab</p></figcaption></figure>

### **Feedback Score Behavior**

Currently, Instruqt **only stores a single feedback submission** per play, meaning that each new score and comment will replace the previous one. The written feedback is tied to the score, so submitting a new score will reset any previously entered comments.

{% hint style="info" %}
For example, if a user rates the track with a score of three during an early challenge, but updates it to a score of two later on, the final feedback recorded for the track will be a score of two.
{% endhint %}

### Configure the track feedback

You can configure a track's feedback using the Instruqt web UI:

{% tabs %}
{% tab title="🌐 Web UI" %}

1. Select the track you wish to configure.
2. In the *Settings* section, click **Edit**.
3. Click **Additional settings**.
4. In the *Track feedback* section, you will see two options:

   1. *After user completes all challenge* - Toggle this option on to enable feedback at the end of the track.
   2. *During any challenge* - Toggle this option on to enable a *persistent feedback tab* displayed during all challenges.

   It is also possible to disable both options to disable feedback for the track entirely.
5. Click **Save**.
   {% endtab %}

{% tab title="track.yml" %}

1. Open the *track.yml* of the desired track.
2. Under the `lab_config` section you can add or modify the following options: `feedback_tab_enabled` and `feedback_recap_enabled`.
3. Set `feedback_tab_enabled` to *true* if you want to enable a *persistent feedback tab* displayed during all challenges.
4. Set `feedback_recap_enabled` to *true* if you want to enable feedback at the end of the track.

\
Example of how a track.yml would look like with both options enabled.

```yaml
slug: mytrack
id: baekpuxv2m5g
type: track
title: MyTrack
teaser: Get started quickly with just one container-based sandbox host.
description: Get started quickly with a container-based sandbox host. Choose a container
  when you need a fast, lightweight Linux system.
...
owner: myteam
developers:
- developer@content.com
...
lab_config:
...
  feedback_recap_enabled: true
  feedback_tab_enabled: true
 ...t
```

{% endtab %}
{% endtabs %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.instruqt.com/tracks/manage/track-feedback.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.