> For the complete documentation index, see [llms.txt](https://synap.ac/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://synap.ac/docs/platform/collections/collection-configuration.md).

# Collection configuration

Collection configuration determines how the collection is displayed to students and how they can interact with its content. This includes the layout, progress display, export options and student-generated practice tests.

{% hint style="info" %}
**Location:** Collections → select a collection → Configure
{% endhint %}

### Settings

| Setting                       | What it changes for students                                                                                                            |
| ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| **Priority display**          | Makes the collection more prominent in the student's Collections list where priority ordering is used. It does not give anybody access. |
| **Layout**                    | Chooses between a browsable set of Cards and a course-style Player with ordered navigation.                                             |
| **Hide overview page**        | In Player view, takes students directly to the first item instead of showing the collection overview.                                   |
| **Display progress tracking** | Shows how much of the collection the student has viewed and the status of individual items.                                             |
| **Annotations**               | In Player view, lets students make personal annotations on supported content such as notes.                                             |
| **Allow export**              | In Player view, lets students export supported collection items.                                                                        |
| **Allow generated attempts**  | Adds **Generate attempt**, allowing students to build practice tests from the collection's quiz questions.                              |
| **Restricted access label**   | Replaces the default wording shown on locked or unavailable items.                                                                      |

![The top of Configure with the Layout setting and collection controls](https://3891068282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWXE6hvHQFtER1a1Dm3l5%2Fuploads%2F8tloSVgElr9nYTCdqPcW%2Flayout-setting.png?alt=media\&token=879cb156-71f9-43db-ac18-a36f8a7f651a)

### Priority display

Use Priority display to make an important collection easier to find in the student's Collections list. It does not give students access, change the order of items inside the collection or override portal filters.

### Layout and overview

Layout has the biggest effect on what the collection feels like to a student. Cards encourages browsing and choice. Player suggests an ordered learning journey. **Hide overview page** makes Player feel even more direct by opening the first item immediately.

Read **Cards and Player views** for a full comparison and student screenshots.

### Progress tracking

When enabled, students can see the percentage of the collection they have viewed and the status of individual items. This helps them keep their place, but it does not mean they have passed a quiz or met a course completion rule.

### Annotations

Annotations are available in Player view for supported content. A student's annotations are personal to them: they do not change the original note or document for anybody else.

### Export

Export appears in Player view for supported items such as notes, quizzes and documents. The options depend on the item being viewed, and locked or unsupported content does not become exportable simply because this setting is enabled.

### Restricted access label

Use this field to replace the general restricted label with language that makes sense for the collection, such as “Coming soon” or “Complete the previous section.” It is display text only: it does not define the condition that unlocks the item.

{% hint style="warning" %}
Avoid wording that promises an automatic unlock unless the item's actual access or schedule configuration provides it.
{% endhint %}

### Generated-attempt configuration

Enabling **Allow generated attempts** reveals the settings used to build student-generated practice tests. You can choose:

* the choices students can make before starting;
* question selection by tags and mastery;
* the tools available during an attempt;
* the results information shown after completion.

![The main controls for choosing the modes, lengths, players and tags available to students](https://3891068282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWXE6hvHQFtER1a1Dm3l5%2Fuploads%2FfGtxx5NDO6srXKAm2cyL%2Fgenerated-attempt-settings.png?alt=media\&token=317d162e-bf9d-4f99-814b-7d01f2e19312)

These settings only apply when a student generates a test from this collection. They do not change the original quiz settings. See **Generated attempts** for a detailed explanation of every option.

### Saving and previewing

Select **Save** to apply your changes. Preview the collection after changing its layout, availability, generated-attempt options or results so you can see the same journey your students will see.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://synap.ac/docs/platform/collections/collection-configuration.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
