# Create a new collection

A collection is like a folder that contains a group of pages. A page is like a file in your Github repository.

{% hint style="info" %}
**A collection can only exist when there is a page inside. So you must create a page in a collection.**
{% endhint %}

![On Github, a collection is a folder](/files/-MP5Bz0MO7EFygR5wzfg)

**Step 1** Create a file, which will represent a page on your site. 

![](/files/-MP5CI_vieOxqRgER1s5)

**Step 2** Specify the folder name

{% hint style="success" %}
A folder for a collection should always **start with underscore (\_).** **Replace spaces between words with dashes (-)**. 

Always keep **all file and folder names in** **small caps**
{% endhint %}

![](/files/-MP5EkG04aIX_cCFzVtI)

**Step 3** Add a forward slash to fix the folder name and set a file name. 

A file name usually corresponds to your page name for easy reference.

  

![By typing the forward slash, you're fixing the file path of the folder](/files/-MP5EuyLWRCiYS5ZEnE-)

**Step 4** Specify the title and permalink of the page 

### Things to note:

1. You should enclose the title and permalink inside three dashes `---`
2. Permalink **should not** have any spaces in between.
3. If you're creating a page inside a collection, you should specify in the permalink that the page is inside the folder. For example, for a page named `My page` inside a folder called `My New Folder`, the permalink will look like this `/my-new-folder/my-page/`

```
---
title: New Page
permalink: /my-new-folder/my-page/ 
---
```

**Step 5** Scroll to the bottom and click commit at the bottom of the page to save the file. 


---

# 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://v2.isomer.gov.sg/get-started/create-a-new-collection.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.