> For the complete documentation index, see [llms.txt](https://docs.didge.io/home/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.didge.io/home/collections/admin/create-a-collection.md).

# Create a Collection

Managing Site Collections

Site Collections allow administrators to organise related components of the Didge Platform—such as operations, checkpoints, submissions, and reports—into logical groups. Collections act as containers that help structure workflows, reporting, and data relationships in a clear and maintainable way.

This guide explains how to access, create, and manage collections within the platform.

***

### Accessing Site Collections

Before managing collections, ensure you are logged in as an Admin user.

1. Navigate to the Department page.
2. Click the three-dot menu (⋮) in the upper-right corner.
3. From the dropdown menu, select Site Collections.

This will take you to the Collections Listing page.

<figure><img src="https://4248908630-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbT2FgjeSTRyDJH1C11vg%2Fuploads%2FlattMCYo1VSuiCg3pJkt%2FScreenshot%202025-12-04%20at%208.11.46%E2%80%AFam.png?alt=media&amp;token=37be5334-e784-4907-bf80-baa17d2f4a0f" alt="" width="178"><figcaption></figcaption></figure>

***

### Collections Listing Page Overview

The Collections Listing page displays all existing collections for the selected site.

Here you will see:

* A table of collections, including:
  * Collection ID (#)
  * Title
  * Description
  * Created At timestamp
* Row actions:
  * Edit an existing collection
  * Delete a collection (irreversible)
* A dropdown arrow to expand a collection and view additional details
* A Show Visualization button to display a visual map of all resources connected to the collection

<figure><img src="https://4248908630-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbT2FgjeSTRyDJH1C11vg%2Fuploads%2Fbmt49hwy3SLwKeGrS11U%2FScreenshot%202025-12-04%20at%208.12.02%E2%80%AFam.png?alt=media&amp;token=943feb4c-835b-4e58-80c0-ffa3fbcb054d" alt=""><figcaption></figcaption></figure>

***

### Adding a New Collection

To create a new collection:

1. From the Collections Listing page, click Add Collection (top-right button).
2. A dialog will appear titled Add New Collection.
3. Fill in the following fields:

#### Title

Provide a clear and meaningful title.

This is important because collections help define functional groupings (e.g., *Cooking CCP*, *Receiving Procedures*, *Daily Sanitation Reporting*).

#### Description

Describe what the collection represents or contains.

This helps other administrators understand its purpose, especially in environments with many collections.

4. Click Add Collection to save.

<figure><img src="https://4248908630-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbT2FgjeSTRyDJH1C11vg%2Fuploads%2Fadwv59v0ZgKoowJ9rk3d%2FScreenshot%202025-12-04%20at%208.12.13%E2%80%AFam.png?alt=media&amp;token=52f7717b-92b0-408d-b221-1f2f4a8e075a" alt="" width="355"><figcaption></figcaption></figure>

***

### Important Note: Collections Start Empty

When you create a new collection, nothing is assigned to it by default.

A collection is simply an empty container at creation time.

Next, you will need to navigate into the relevant areas of the platform—such as operations, checkpoints, submissions, corrective actions, or reports—and attach those resources to the collection.

This ensures each collection contains only the components you explicitly choose to associate with it.

***


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.didge.io/home/collections/admin/create-a-collection.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
