This Article shows how you can use the category_array field to access the IDs of the Categories assigned to a WebApp or Module Item
In this set of Articles, we'll show you the Liquid syntax needed to get the most out of Categories on the Front End.
The following features are available in WebApp and Module Layouts only, as they require access to a particular Item's category_array
field. In Module Layouts, they'll only be available in the item.liquid
file.
Using the category_array field to access the IDs of Categories that have been assigned to the current Item
Displaying all Categories that belong to the current Item
Displaying the first, last or nth Category which belongs to the current Item
Check if an Item has an Nth Category assigned to it
Each WebApp or Module Item has a Category Array field stored inside the this
object. For WebApps, you can access this in the Layout file. For Modules, you can access this in the item.liquid
file in the Layout folder: {{this.category_array}}
This will output the IDs of Categories which are assigned to the current Item in an array e.g. if the Item is assigned to Categories with ID 1 and 2 it will look like this:
To loop over all these Category IDs you can use a Liquid For Loop:
Once you have the Category ID, you can use the Categories data object to access any other Category fields, e.g. the name:
Instead of using a Loop, you can access a specific index of the category_array
field and use it to fetch a particular Category ID.
You can use the following to only output the name of the first category assigned to the Item:{{context.exports.categories.data[this.category_array.first].name}}
You can use the following to only output the name of the last category assigned to the Item:{{context.exports.categories.data[this.category_array.last].name}}
You can use the following to only output the name of a specifc category assigned to the Item, by its zeroed-index, where 0 is the first and 1 is the second:
If you want to make sure the category item in the array you are calling exists first, then you should do the following: First category in the array:
Second category in the array (and so on):
Categories are an excellent method for sorting and grouping content on your Site in an intuitive, hierarchical way.
Categories can be useful in a number of situations:
segmenting blogs and services
displaying related services on a page due to those items being in the same category.
Categories are also used in eCommerce to form product catalogues and groups.
Building a menu of categories with items displayed underneath
Each Category can optionally have an automatic system detail Page enabled for it, which will be accessible at a URL which is based off the category's ancestor's in the hierarchy, followed by its own unique slug e.g. the following category structure:
Shop
Clothing
Unisex
Hats
Would have the following URL for the Hats detail page:
You can optionally apply a Category Detail Layout to all of these enabled detail Pages.
This Article shows how to filter WebApp and Module Items using their category_ids parameter.
In this set of Articles, we'll show you the Liquid syntax needed to get the most out of Categories on the Front End.
You can use Category IDs to filter WebApp, Module or eCommerce Product Items when including a List View in the Page.
You can filter by a single Category using category_ids:
You can filter by multiple Categories using comma-separated values in the category_ids parameter:
This parameter works whether you're filtering WebApps or Modules!
If you filter by a Category which contains sub-Categories, the results will include all Items belonging to the Sub-Categories.
E.g. If you have a Products Category containing Merchandise and Music, filtering by the ID of the Products Category will return all Items belonging to Products, Merchandise and Music.