# Configure collections

This doc will run through how to configure your Synap Collections for users to your learning specifications. Learn about the different layout options and how to add tracking, give locked items custom labels, pinning priority collections set generated attempt settings and more. Remember if you want to try out Synap for yourself we've got tonnes of demo content on our demo universe portal head over to <https://universe.synap.ac> of click [here](https://universe.synap.ac/join/sEqFLDslru) to get access.

Once you've created a Collection go to the Configure page here you'll find all the options available, for more detail on each option, hover over the `?` hotspot. &#x20;

<figure><img src="/files/gJPDRno5Ew9vVktk6b47" alt=""><figcaption><p>Collection configure page</p></figcaption></figure>

{% hint style="info" %}
💡 Top tip: From collection items hit preview at any time to view your collection as a student to check you're happy with the configuration!&#x20;
{% endhint %}

<figure><img src="/files/sN9BkwVJtV5lM0lWt7kO" alt=""><figcaption><p>Previewing a Collection as a student</p></figcaption></figure>

## 📍Priority display

By default collections display to users ordered by when they were created with the newest showing at the top and oldest at the bottom. You can set a priority display on collections to make sure they will always show at the top. Perfect for if some collections are more important than others. &#x20;

<figure><img src="/files/cwDUJhGcCLiHhMrN5p3B" alt=""><figcaption></figcaption></figure>

## 🎭 Layouts

There are two layouts to choose from for collections: Card or Player. Card is generally used if you want users to treat their Collections as a folder of content, where as the Player gives a more linear course feel and structure

### 🃏 Card

Cards organise content and folders into a card view, you can customise the folder and content covers in the editor

<figure><img src="/files/vCGfM8EU5YUHEqJj0hVW" alt=""><figcaption><p>Collection in Card view </p></figcaption></figure>

### ▶️ Player

The Collection player is a more linear style of learning for users. Content is arranged into collapsed folders, and shown to users on the left hand side. Users can navigate items using the previous / next buttons.

<figure><img src="/files/HE5VVMH2EisUXhrZSeHF" alt=""><figcaption><p>Collection player </p></figcaption></figure>

## 🐾 Tracking

Enable tracking to visualise your journey through the collection through cards or the player! With this feature, you can easily see the status of each item:

* 🔵 Blue = New items added since your last visit.
* 🟢 Green =  Items you’ve already explored.
* ⚪️ Grey = Items yet to be discovered.

<figure><img src="/files/Bwr8O2a5Bk1MC3NH769S" alt=""><figcaption><p>Collection player with tracked progress </p></figcaption></figure>

## 🏷 Custom restricted item labels

You can restrict access to collection items within a collection, these show as greyed out and 'Coming soon' on both card and player views by default. You can pick an alternative label like 'Locked' or 'Upgrade for more'.&#x20;

{% hint style="info" %}
💡 **Top tip**: If you have a collection and you want to give a sample of it away for free you can set up 2 collections, a free one and an paid / full access one (use the cloning feature to speed this up). restrict the items you don't want users to have until they have full access. Then give access to the free collection to a custom student user group, and then give access to the group via your website or using user group share links ([more here](/doc/users-and-groups/creating-groups/user-group-sharing-links.md)).&#x20;
{% endhint %}

<figure><img src="/files/xGbWgWF8BB48KUgP7hX0" alt=""><figcaption><p>Collection with restricted items, use different collection item cards to further customise</p></figcaption></figure>

Then when you're users upgrade either manually or through an automation, remove them from the free collection group, thus removing their access to the free collection items, then give them access to the full access collection with the same items but unlocked.&#x20;

<figure><img src="/files/sYtY3rlxuZ0SN82ON1Qk" alt=""><figcaption><p>Example full access / upgraded collection </p></figcaption></figure>

From the students point of view they've just unlocked everything but behind the scenes they've moved to a new collection and user group.&#x20;

## 🎱 Generated attempts

Activate generated attempts to let users create personalised quizzes! Set the specific tag facets you want available for users to choose from, the lengths and modes. This feature pools all questions within a collection, offering a dynamic and customisable quiz experience. Enhance engagement and allow learners to focus on specific areas of interest.

<figure><img src="/files/ksfBESReabPfV9fYu7r7" alt=""><figcaption><p>Generated attempt settings</p></figcaption></figure>

Where timed exam is enabled, the system will use the time set on each question which if left blank defaults to 2 minutes to calculate the overall allowed time.&#x20;

<figure><img src="/files/7FGLwf3OCPKV9a4vaunj" alt=""><figcaption><p>Student generating an attempt from a collection with dropdown enabled</p></figcaption></figure>

To get this feature to work you'll need to have set up tags and facets on your questions, see our guide for more

{% content-ref url="/pages/9T2iftAc4DNFUJE76ov7" %}
[Tags & facets](/doc/analytics/tags-and-facets.md)
{% endcontent-ref %}

### Dropdown vs Toggle display

Select either **Dropdown** or **Toggle** options for how to display the different tag facets. Both options will lead to the same options for student's but your choice will depend on the UI you want for your users and how many tags you have to show.&#x20;

{% hint style="info" %}
If you have hundreds of tags then dropdown is more likely the best option as it condenses everything down into lists. Whereas toggle will show users everything upfront without them needing to know which tags belong to which facets.&#x20;
{% endhint %}

#### Dropdown

Displays to users each tag facet with a drop down list to select the exact tags they want to be used in their generated quizzes.

<figure><img src="/files/7QlsMZmxRzCfQ5YHyuuC" alt=""><figcaption><p>Dropdown </p></figcaption></figure>

#### Toggle

Toggle display will list out all the tags in each facet group

<figure><img src="/files/tx8l9WRSn2WCRbaZgi49" alt=""><figcaption><p>toggle</p></figcaption></figure>

### Additional generated attempt options

Once you have enabled generated attempts, you can begin configuring the options your users will have to choose from.

| Settings to consider         | Description                                                                                                                |
| ---------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| Allow multiple tag selection | When enabled students can choose more than one tag for each facet                                                          |
| Exclude untagged questions   | When enabled any questions that do not have tags will be excluded from the generation filters and not included in attempts |
| Show mastery filters         | When enabled in-combination with the users study page, users will be able to filter questions by mastery level             |

### Mastery levels & the study

If you haven't got the study enabled for your users then you shouldn't enable show mastery filters. If users are using the Study then show mastery level is a great way to let your users really target their weaker areas and make sure they're practicing the right questions to improve.&#x20;

<figure><img src="/files/ckD5eHKrez2jGXgRPTQW" alt=""><figcaption><p>Mastery levels in attempt generation </p></figcaption></figure>

Learn more about the study and mastery levels from the doc below&#x20;

{% content-ref url="/pages/POVEZfDGlids9jCEV5v3" %}
[Collections and the Study](/doc/collections/collections-and-the-study.md)
{% endcontent-ref %}


---

# 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://academy.synap.ac/doc/collections/creating-collections/configure-collections.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.
