> 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/items-folders-and-ordering.md). # Items, folders and ordering The Items page shows everything inside the collection. Use it to add content, organise it into folders, choose its order and decide when students can open each item. {% hint style="info" %} **Location:** Collections → select a collection → Items {% endhint %} ### Item types | Type | What students can do with it | | ------------ | ----------------------------------------------------------------------------------------------------------------------------- | | **Quiz** | Opens a quiz for the student. Its questions can also be used in generated attempts and mocks. | | **Note** | Displays authored rich-text content. In Player view, supported note settings and collection annotations can be applied. | | **Document** | Displays an uploaded document using the configured document viewer. | | **Video** | Plays a referenced video item. | | **Audio** | Plays a referenced audio item. | | **Embed** | Displays supported externally hosted or embedded content. Availability can depend on the external service and browser policy. | | **ZIP** | Makes an uploaded ZIP archive available as a collection item. | When adding an item, you can select an existing Library item or create one when your permissions allow it. The source item remains reusable: editing its content can affect every place where it is referenced. ### Reusing Library items | Source Library item | Placement in this collection | | --------------------------------------------------------------- | ---------------------------------------------------------------------- | | The quiz questions, note body, file, video or embedded resource | The title and descriptions shown for this occurrence | | The reusable content identifier | The folder or sub-folder containing it | | Content-level configuration | Its order, cover image, custom type label, release status and schedule | | Quiz definition | Whether a quiz can be added to Study from this collection | This means the same quiz can appear in two collections with different display titles and schedules while still using the same questions. Editing those questions changes both collections; changing the title or schedule for one placement does not. ### Folders, sub-folders and ordering Folders divide a collection into clear sections, such as subjects, topics or weeks. A folder can contain items and sub-folders, and each sub-folder can contain its own items. Use the drag handles to arrange them in the order you want students to see. ![The Items page showing a parent folder, a child folder, several item types and drag handles](https://3891068282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWXE6hvHQFtER1a1Dm3l5%2Fuploads%2FZuW6xyWAG0y9KecnX2hm%2Ffolders-and-items.png?alt=media\&token=4b9adc27-ef2c-45b7-b798-2e2511e16fc0) Ordering has a different weight in each layout: * In **Cards view**, order controls the sequence in which cards and folders are displayed, but students still choose what to open. * In **Player view**, order defines the contents menu and the path followed by **Previous** and **Next**. It therefore implies a learning sequence. Moving an item only changes where it appears in this collection. It does not move or edit the original Library item. If you use Player view, preview the collection after reordering it because the same order controls the **Previous** and **Next** journey. ### Item presentation fields Open an item from the collection to change how it appears here. You can give it a collection-specific title, image, short description, full description and custom type label. The available fields depend on the item type. ![The settings for an item placed inside a collection, including Locked, schedule, folder and display fields](https://3891068282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWXE6hvHQFtER1a1Dm3l5%2Fuploads%2FscehGmgMrT721sYQgWfE%2Fitem-settings.png?alt=media\&token=cb7e3cfb-6907-4965-8746-8544d92d02fc) The **custom type label** replaces the normal label such as Quiz, Note or Document for this collection entry. It does not convert the item into another type or change how Synap opens it. ### Availability controls Three settings can affect whether a student can open an item: | Control | Effect | | ------------------------- | ------------------------------------------------------------------------------------------------- | | **Locked / Preview only** | Keeps the item visible as upcoming or restricted but prevents students from opening it. | | **Open date** | Keeps the item unavailable until the specified date and time. | | **Close date** | Makes the item unavailable after the specified date and time. Omit it for an indefinite schedule. | Synap applies these settings together. A locked item stays unavailable even if its schedule is open. An unlocked item is available only while its schedule is active. Both Cards and Player can show unavailable items, so students can see that more content exists without being able to open it yet. The **Restricted access label** on Configure changes the general label shown for restricted items. A scheduled item can instead show its availability date where supported. {% hint style="warning" %} Before relying on a schedule, preview the collection and check that the date, time and portal time zone match the release you intend. {% endhint %} ### Add to Study For quiz items, **Enable “Add to study”** lets students add that quiz to their personal Study area. This is separate from opening the quiz normally and from generating a test using questions across the collection. * **Enabled:** the student can add or remove the quiz from their Study material where Study is available. * **Disabled:** the collection does not show that Study action for this quiz. ### Candidate progress If **Display progress tracking** is enabled on Configure, students can see how much of the collection they have viewed and which items they have opened. This is useful as a learning indicator, but it is not the same as passing a quiz or completing a course. ### Removing an item Removing an item takes it out of this collection but does not normally delete it from the Library. The item also disappears wherever this collection is being used, including future visits through an assignment. {% hint style="info" %} If a student cannot find or open an item, check its folder, lock status, schedule and the collection's User groups before editing the original Library item. {% endhint %} --- # 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/items-folders-and-ordering.md?ask=&goal= ``` `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.