There will be times where you don’t need a page or a post, but still need to group bits of content together. This is exactly what collections are: they are groups of documents that aren’t in any particular order.
For each collection, a new directory will be created in your project called
_[collection name]/ (e.g.,
_people/). Additionally, a piece of configuration will be added to your
_config.yml file that defines the collection with its title and any metadata attached to it.
By default, a collection’s documents are generated into their own pages when they’re published. It will generate these pages out into children of the parent collection. For example, if you had a document called
Ethan in a collection called
People, it will generate a page located at
If you turn this option off, you’ll still be able to access your documents in your layouts through the Collection Liquid attribute. For example, you’d be able to access the documents in the
People collection by calling
Changing the path changes the location of the generated collection directory and the path the collection is accessible at on your site.
The permalink changes the path the collection is accessible at on your site.