# 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="https://2094212015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MGJDYBXyftBAZb1Wq0e%2Fuploads%2Ffi0FeBHyFalUxznkOHaY%2Fimage.png?alt=media&#x26;token=7e489097-1a4f-4bd2-b877-4cbd51452de9" alt=""><figcaption><p>Happiness rating  scale</p></figcaption></figure>

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

<figure><img src="https://2094212015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MGJDYBXyftBAZb1Wq0e%2Fuploads%2FkOWYAMtidlfTsrOb404U%2Fimage.png?alt=media&#x26;token=c25ec36f-4a6c-4851-b3ec-1c1be2d804c0" 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="https://2094212015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MGJDYBXyftBAZb1Wq0e%2Fuploads%2FDciJ4Tcb8WJ636bsHejW%2Fimage.png?alt=media&#x26;token=58ef615d-d624-4af3-a8ec-e2c289f345a6" 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 %}