> For the complete documentation index, see [llms.txt](https://v2.isomer.gov.sg/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://v2.isomer.gov.sg/get-started/create-a-new-collection.md).

# 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.