Squarespace Developer Platform: APIs, Apps, and Docs
Squarespace Tags

Category Tag

Category Tags in Squarespace are a way to dynamically display the categories from the collection being viewed. Handy for a Blog or Events collection and can assist in navigating large collections.

Similar to a Navigation Tag, you can bind the category information to a template (.block file) to create the markup of the categories (when you do, the tag should be self-closed). Although, the template attribute is optional, a Squarespace Category Tag requires the collection attribute be populated with the collection url ID as shown in this example:

Code
<squarespace:category collection="{urlId}" template="category-slugs" />

As an alternative, you can omit the template and just create the markup inline by using a non-self-closing version of the Squarepace Category tag and putting your markup inside as shown in this fine example:

Code
{.section collection} ... <squarespace:category collection="{urlId}"> {.if categories} <div class="category-wrapper"> <span class="category">{.repeated section categories}{name}{.alternates with}, {.end}</span> </div> {.end} </squarespace:category> ... {.end}

A Category Tag can also be a great way to 'filter' large galleries of work and can be used in either a .region or .list file.