Collections

Squarespace allows you to have an unlimited number of collection types in each site. Each collection can be configured to support specific post types and can be sorted chronologically (like a blog) or user ordered (like a gallery). Each collection must have a configuration file (.conf) and at least one .list or .item file.

Collection Configuration (collection.conf)

Contains the configuration settings for a collection. There is one configuration file for each collection.

{
  "title" : "Blog",
  "ordering" : "chronological",
  "addText" : "Add Post",
  "acceptTypes": [ "text" ]
}

Configuration Options

title The name of the collection as it will appear in the "Add New Page" dialog.

ordering The method of ordering for the collection. Available options: chronological, user-orderable, calendar.

addText Specifies the text used in the "add" button in the Squarespace interface. It is also used in empty collection message when a collection does not contain any items.

acceptTypes Specifies the post types allowed in this collection. Available: text and image.

Collection List Views (collection.list)

This is the default view of every collection and shows all posts in that collection. For example, blog.list templates a list of blog posts.

Collection Item Views (collection.item)

Item views are templates for the individual pages of a collection item (permalink). Example: blog.item templates a single blog post page.

TIP: Exclude the .list file to start on item view

If a .list file is not provided, the .item becomes the default template for the collection, thus starting viewers on the first individual item page instead of the collection's list page.