website logo
⌘K
Introduction
PORTAL
Agency Whitelabelling
PAGES
Pages - Accessing Page Data
Pagination Layouts
Page Templates
FORMS
Form Confirmation Pages
Adding a Progress Bar
Adding Custom CSS To Show Form Submit Process
Dynamic Content in Workflow and Autoresponder Emails
How to output Custom Field Set fields in a Form's Custom Layout
Custom JavaScript Validation for Forms
File Upload Previews
FAQ
CATEGORIES
Filtering WebApps and Modules by Categories
Outputting Categories on WebApp / Module / eCommerce Layouts
Outputting Category Fields in any Location
Category Detail Layouts
FAQ
COMPANY INFORMATION
Company Information
SITE SEARCH
Site Search
PUBLIC API/ZAPIER
Zapier - Formatting arrays correctly
Public API/Zapier Changelog
MODULES
Module Marketplace
Building Custom Modules
Siteglide Modules
Front-end Submit Modules
DATA STRUCTURES
Automations
Creating WebApps from the CLI
Field Types
WEBAPPS
Front-end Submit WebApps
Layouts
Search and Filtering
Understanding Custom Field Names and IDs
FAQ
CRM
User Details
User Secure Zones
Storing User's Favourite WebApp / Module Items
User's Form Submissions (Cases)
How Users Edit their Email and Password Front End
Editing a User's CRM record Front End with Custom Field Sets
CLI
Introducing Siteglide CLI
CLI Changelog
Secure Zones with CLI
Page Templates with Siteglide CLI
Pages with Siteglide CLI
Includes with Siteglide CLI
Managing Email Templates
Migrate - Manual Form setup
Migrate - Convert existing Forms
Liquid
Accessing Assets
Liquid Dot Notation
Using WebApp Collections- Tutorial
Using the current_user object with Secure Zones
Preventing Duplicate Content with Query Parameters- Canonical URL and Robots.txt
FAQ
GraphQL
Tutorial Overview
About GraphQL
Tutorial 1- Your First Query
Tutorial 2 - Pagination
Tutorial 3 - Filtering the Results
Tutorial 3 - Answers to the First Filtering Challenge
Tutorial 4 - Advanced Filtering
Tutorial 4 - Challenge Answers
Tutorial 5 - Using Liquid to run GraphQL queries on your Site
Tutorial 6 - Variables
Tutorial 6 - Answers to the Variables Challenge
Tutorial 7 - Sorting
Tutorial 8 - Building a Liquid API GET Endpoint Page powered by GraphQL queries
Best Practice and Performance
Module/WebApp Caching
Getting Started with Liquid Caching - to Reduce Server Response time and Improve Performance
Includes
ecommerce/checkout_standard
Frequently Asked Questions
Using Liquid Logic to Check if a field exists, or is empty on the Front End
How do I learn more about Liquid?
How to setup a multi domain start page
Docs powered by archbee 
14min

Outputting Categories on WebApp / Module / eCommerce Layouts

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

Introduction

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

Accessing the Category Array Field

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:

HTML
|

Displaying all Categories that belong to the current Item

To loop over all these Category IDs you can use a Liquid For Loop:

HTML
|

Once you have the Category ID, you can use the Categories data object to access any other Category fields, e.g. the name:

HTML
|

Displaying the first, last or nth Category which belongs to the current Item

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.

First in Category Array

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}}

Last in Category Array

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}}

Nth in Category Array

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:

HTML
|

Check if an Item has an Nth Category assigned to it

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:

HTML
|

Second category in the array (and so on):

HTML
|

Updated 19 Oct 2021
Did this page help you?
Yes
No
UP NEXT
Outputting Category Fields in any Location
Docs powered by archbee 
TABLE OF CONTENTS
Introduction
Accessing the Category Array Field
Displaying all Categories that belong to the current Item
Displaying the first, last or nth Category which belongs to the current Item
First in Category Array
Last in Category Array
Nth in Category Array
Check if an Item has an Nth Category assigned to it