> 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/library/library-items.md).

# Library items

The Library is the central workspace for creating, finding and managing reusable content. Items can be reused in courses, collections and assignments without recreating the underlying content.

{% hint style="info" %}
**Location:** Library
{% endhint %}

### Library item types

Select **Create or upload** and choose an item type.

| Item type      | What it is                                                                        | Typical uses                                                         |
| -------------- | --------------------------------------------------------------------------------- | -------------------------------------------------------------------- |
| **Quiz**       | A structured set of questions with configurable scoring, grading and results.     | Exams, practice tests, knowledge checks and question banks.          |
| **Note**       | A page authored in Synap's rich-text editor.                                      | Reading material, instructions, explanations and supporting content. |
| **Survey**     | A set of structured response fields designed to collect information from users.   | Feedback, declarations, confidence checks and data collection.       |
| **Document**   | An uploaded document that users can open through Synap.                           | Handbooks, worksheets, policies and reference material.              |
| **Video**      | An uploaded video file presented as a Library item.                               | Lectures, demonstrations and recorded briefings.                     |
| **Audio file** | An uploaded audio recording.                                                      | Podcasts, listening exercises and spoken instructions.               |
| **ZIP file**   | A downloadable ZIP archive.                                                       | Resource packs or files that need to retain a folder structure.      |
| **Embed**      | Content hosted elsewhere and displayed or linked from Synap.                      | Interactive tools, web content and externally hosted media.          |
| **SCORM file** | A Sharable Content Object Reference Model (SCORM) package uploaded as a ZIP file. | Interactive e-learning packages exported from authoring tools.       |

{% hint style="info" %}
Choose the type based on how users need to interact with the content. For example, use a **Quiz** when responses need question-level marking, and a **Survey** when the main purpose is collecting information.
{% endhint %}

### Find and organise items

The Library provides several ways to work with a growing catalogue:

* **Search** finds items by title.
* **Filter** narrows the list using the fields available to your portal.
* **Columns** controls which metadata is visible in the table.
* **Table and card views** change how items are displayed.
* **Attributes** add portal-specific metadata that can be used to classify and filter content.

Select multiple rows to apply supported bulk actions, including deleting items or editing attributes.

### Common item actions

The actions available depend on the item type and your permissions.

| Action              | What it does                                                        |
| ------------------- | ------------------------------------------------------------------- |
| **Edit**            | Opens the item's builder or settings.                               |
| **View or preview** | Opens the item without changing its content.                        |
| **Clone**           | Creates a separate copy that can be edited independently.           |
| **Access**          | Controls which users or groups can find and use the item.           |
| **Delete**          | Removes the item. Check where an item is in use before deleting it. |

{% hint style="info" %}
Use clear titles and attributes at creation time. A well-structured Library is much easier to search, reuse and automate later.
{% 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/library/library-items.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.