Track time limits

Learn how to configure track time limits and idle timeouts

Overview

Every Instruqt track has two parameters that cause a user's session to expire: a track time limit and an idle timeout. The track time limit is required and restricts how long a user can interact with your track. The idle timeout is optional but highly encouraged and restrict how long a user can be away from the track (in a different window, etc.) before their session expires.

Track time limits

You can configure a track time limit using the Instruqt web UI or CLI:

Select the track you wish to modify the time limit of.
In the Settings section, click Edit.
In the Time limit field, enter the desired value in minutes.
Click Save.

If you have not already done so, pull the track you wish to modify the time limit of:
```
instruqt track pull <track-slug>
```

Open the track.yml file and add a timelimit parameter.

timelimit: <value-in-seconds>

As an example, the file might look like the following:

slug: example-track
id: xnlauwy2zewf
title: Example Track
...
timelimit: 3600

From within the track directory, push the update to Instruqt:
```
instruqt track push 
```

Extend the time limit

You can allow users to increase their time limit themselves. When enabled, a prompt will appear when a track reaches its limit, allowing users to add more minutes. The maximum amount of extra time that users can add is customized for each track.

You can allow users to extend the time limit using the Instruqt web UI or CLI:

Select the track you wish to allow users to extend the time limit for.
In the Settings section, click Edit.
Click Additional settings.
Toggle Allow users to extend their session on, and input the desired value in minutes.
Click Save.

If you have not already done so, pull the track you wish to modify the extend ttl of:
```
instruqt track pull <track-slug>
```

Open the track.yml file and add an extend_ttl parameter.

extend_ttl: <value-in-seconds>

As an example, the file might look like the following:

slug: example-track
id: xnlauwy2zewf
title: Example Track
...
timelimit: 3600
extend_ttl: 600

From within the track directory, push the update to Instruqt:
```
instruqt track push
```

Idle timeouts

There are two ways to configure a track's idle timeout:

Within the Track details page.
Using the Instruqt CLI and configuring the idle_timeout parameter.

Websites or applications opened in external tabs or browser windows (outside of the Instruqt lab UI) are not considered by the idle timer. This means that activity in those external tabs will not reset the timer, and the track may time out even if the user is active there.

Configure idle timeouts

You can configure a track's idle timeout using the Instruqt web UI or CLI:

Select the track you wish to modify the idle timeout of.
In the Settings section, click Edit.
Click Additional settings.
Toggle Time out idle users on, and input the desired value in minutes.
Click Save.

If you have not already done so, pull the track you wish to modify the idle timeout of:
```
instruqt track pull <track-slug>
```

Open the track.yml file and add a idle_timeout parameter.

idle_timeout: <value-in-seconds>

As an example, the file might look like the following:

slug: example-track
id: xnlauwy2zewf
title: Example Track
...
timelimit: 3600
idle_timeout: 300

From within the track directory, push the update to Instruqt:
```
instruqt track push 
```

PreviousTrack logs NextPausable tracks

Last updated 11 months ago

Was this helpful?