Objects

Liquid objects represent variables that you can use to build your theme. Object types include site resources, standard Basker content, and functional elements that help you to build interactivity.

Objects might represent a single data point, or contain multiple properties. Some properties might represent a related object, such as a event in a season.

Note

Liquid objects are also often referred to as Liquid variables.

Usage

Objects, along with their properties, are wrapped in curly brace delimiters {{ }}.

For example, the event object contains a property called title that can be used to output the title of a product.

Code

{{ event.title }}

Data

{
    "event": {
        "title": "Hamlet"
    }
}

Output

Hamlet

Object access

The way that you access an object depends on the object and the context in which you want to access it. An object might be accessed in the following ways:

• Globally: The object can be accessed directly in any Liquid theme file.
• In a template: The object can be accessed directly in specific templates, or in sections or blocks included in the template. For example, you can access the event object directly in a event template, or a section referenced in a event template.
• Through a parent object: Many objects are returned by another object, or as a property of a parent object. For example, you can access post objects through the global posts object, or through the posts property of the blog object.

Refer to each object to learn about how it can be accessed.

Creating

You can also create your own variables using variable tags. Variables are treated like objects syntactically.

Code

{% assign my_variable = 'My custom string.' %}
{{ my_variable }}

Output

My custom string.

Event Data Model

event object

An event in Basker.

Property	Type	Description
id	string	The unique identifier for the Event in Basker CMS.
title	string	The name or title of the Event.
description	string	A short description of the event.
image	object	The main image associated with the event.
slug	string	The unique, URL-safe identifier for the event.
venue	venue	The venue associated with the event. Includes id and name.
company	organization	The production company name, if specified.
startDate	string	The start date of the event.
endDate	string	The end date of the event.
duration	number	The duration of the event in minutes, if provided.
work	work	A reference to the work being performed.
season	season	The associated season with id and title (e.g., “2024/25 Season”).
series	series	A series to which the event belongs, if specified.
participants	array of person groups	Groups of participants, such as cast or crew, with name, role, and id.
blocks	array of blocks	A dynamic array of content blocks. Depends on the theme configuration.
media	array of media	Media assets, including images or videos linked to the event.
instances	array of event_instance	Event performance instances with individual dates and times.
customAttributes	object	User-defined custom attributes for the event.
theme	object	Developer-defined theme fields for the theme.
meta	object	SEO metadata for the event. Includes title, description, and image.
updatedAt	string	Timestamp of the last update.
createdAt	string	Timestamp of when the event was created.

---

event_instance object

An event instance represents a single occurrence or performance of an event.

Property	Type	Description
id	string	The unique identifier for the Event Instance in Basker CMS.
event	event	The parent event details associated with this instance. Includes id.
startDate	string	The start date and time of the event instance.
endDate	string	The end date and time of the event instance, if specified.
venue	venue	The venue where the instance occurs. Includes id and name.
company	string	The production company name for this instance, if overridden.
work	string	A reference to the work being performed, if overridden.
series	array	An array of series this instance belongs to. Includes title and id.
participants	array of person	A list of participants (e.g., cast or crew) specific to this instance.
customAttributes	object	Custom user-defined attributes specific to this instance.
updatedAt	string	Timestamp of the last update to the event instance.
createdAt	string	Timestamp of when the event instance was created.

---

person object

A person entity in Basker CMS.

Property	Type	Description
id	string	The unique identifier for the person in Basker CMS.
name	string	The full name of the person.
firstName	string	The first name of the person.
lastName	string	The last name of the person.
pronouns	string	Pronouns associated with the person, e.g., he/him/his.
biography_html	html	The person’s biography rendered as HTML
slug	string	The unique, URL-safe identifier for the person.
image	media	Image object associated with the person. Includes url, filename, and dimensions.
blocks	array of blocks	A dynamic array of content blocks related to the person.
attributes	object	Custom attributes for the person.
createdAt	string	Timestamp when the person was created.
updatedAt	string	Timestamp when the person was last updated.

---

season object

A season entity in Basker CMS.

Property	Type	Description
id	string	The unique identifier for the season in Basker CMS.
title	string	The title of the season.
description	string	The description of the season.
slug	string	The unique, URL-safe identifier for the season.
startDate	string	The start date of the season in ISO 8601 format.
endDate	string	The end date of the season in ISO 8601 format.
description	string	A description of the season, if available.
events	array of events	An array of event IDs associated with this season.
blocks	array of blocks	A dynamic array of content blocks related to the season.
attributes	object	Custom attributes for the season.
createdAt	string	Timestamp when the season was created.
updatedAt	string	Timestamp when the season was last updated.

---

series object

A series entity in Basker CMS.

Property	Type	Description
id	string	The unique identifier for the series in Basker CMS.
title	string	The title of the series.
description	string	The description of the series.
slug	string	The unique, URL-safe identifier for the series.
description	string	A description of the series, if available.
startDate	string	The start date of the series in ISO 8601 format.
endDate	string	The end date of the series in ISO 8601 format.
events	array of events	An array of events associated with this series. Includes event IDs.
instances	array of event_instance	An array of event instances tied to the series.
blocks	array of blocks	A dynamic array of content blocks related to the series.
attributes	object	Custom attributes for the series.
createdAt	string	Timestamp when the series was created.
updatedAt	string	Timestamp when the series was last updated.

---

work object

A creative work entity in Basker CMS.

Property	Type	Description
id	string	The unique identifier for the work in Basker CMS.
title	string	The title of the work.
description	string	The description of the creative work.
slug	string	The unique, URL-safe identifier for the work.
description	string	A description of the work, if available.
author	string	The author or creator of the work. Referenced via ID.
firstPerformedDate	string	The date when the work was first performed.
blocks	array of blocks	A dynamic array of content blocks related to the work.
attributes	object	Custom attributes for the work, such as metadata (e.g., author).
createdAt	string	Timestamp when the work was created.
updatedAt	string	Timestamp when the work was last updated.

---

venue object

A venue entity in Basker CMS.

Property	Type	Description
id	string	The unique identifier for the venue in Basker CMS.
name	string	The name of the venue.
description	string	The description of the venue.
slug	string	The unique, URL-safe identifier for the venue.
country	string	The country where the venue is located (ISO Alpha-2 code).
addressLine1	string	The first line of the venue’s address.
addressLine2	string	The second line of the venue’s address, if applicable.
city	string	The city where the venue is located.
state	string	The state or region where the venue is located.
postalCode	string	The postal or ZIP code of the venue.
blocks	array of blocks	A dynamic array of content blocks related to the venue.
attributes	object	Custom attributes for the venue.
createdAt	string	Timestamp when the venue was created.
updatedAt	string	Timestamp when the venue was last updated.

---

organization object

An organization entity in Basker CMS.

Property	Type	Description
id	string	The unique identifier for the organization in Basker CMS.
name	string	The name of the organization.
slug	string	The unique, URL-safe identifier for the organization.
description	string	A description of the organization, if provided.
type	string	The type or category of the organization, if specified.
blocks	array of blocks	A dynamic array of content blocks related to the organization.
attributes	object	Custom attributes for the organization.
createdAt	string	Timestamp when the organization was created.
updatedAt	string	Timestamp when the organization was last updated.

Page Model

page object

A page entity in Basker CMS.

Property	Type	Description
id	string	The unique identifier for the page in Basker CMS.
title	string	The title of the page.
slug	string	The unique, URL-safe identifier for the page.
blocks	array of blocks	A dynamic array of content blocks on the page.
meta	object	SEO meta information including title and description.
breadcrumbs	array of object	Navigation breadcrumbs for the page. Includes label and url.
parent	string	The parent page, if applicable.
sort	number	The sort order of the page relative to other pages.
theme	object	Theme data applied to the page, if any.
createdAt	string	Timestamp when the page was created.
updatedAt	string	Timestamp when the page was last updated.

---

theme object

A theme entity in Basker CMS, used to manage styles, templates, and settings for websites.

Property	Type	Description
id	string	The unique identifier for the theme in Basker CMS.
name	string	The name of the theme.
description	string	A brief description of the theme, if provided.
author	string	The author of the theme.
version	string	The version number of the theme.
settings	object	A collection of customizable theme settings such as colors, social links, and logo.
manifest	object	The theme manifest containing templates, layouts, and block schemas.
filename	string	The uploaded theme file name.
mimeType	string	The MIME type of the theme file.
filesize	number	The size of the theme file in bytes.
url	string	The URL to download the theme file.
createdAt	string	Timestamp when the theme was created.
updatedAt	string	Timestamp when the theme was last updated.

Manifest

The manifest property contains information about the theme structure, including:

• Templates: Defines collections, template files, and associated schema.
• Blocks: A list of reusable content blocks and their settings.
• Layouts: Layout files for the theme (e.g., default.liquid, system.liquid).
• Theme Settings: Customizable settings grouped under fields like logo, colors, social, and newsletter.

---

collection object

A collection entity in Basker CMS, which groups events based on specific conditions.

Property	Type	Description
id	string	The unique identifier for the collection.
title	string	The title of the collection.
slug	string	The URL-safe identifier for the collection.
description	string	A textual description of the collection.
type	string	The type of collection: manual or automated.
conditionType	string	Specifies whether all or any conditions are required for automation.
conditions	array of object	An array defining the conditions for automated collections.
sort	string	Sort order of entities, e.g., performDateAsc.
events	array of object	A list of events included in the collection.
meta	object	Metadata for SEO, including title, description, and image.
createdAt	string	Timestamp when the collection was created.
updatedAt	string	Timestamp when the collection was last updated.

---

blog object

A blog entity in Basker CMS, which represents a structured collection of posts.

Property	Type	Description
id	string	The unique identifier for the blog.
title	string	The title of the blog.
slug	string	The URL-safe identifier for the blog.
meta	object	Metadata for SEO, including title, description, and image.
image	object	The main image associated with the blog.
createdAt	string	Timestamp when the blog was created.
updatedAt	string	Timestamp when the blog was last updated.

post object

A post entity in Basker CMS, typically representing a blog post.

Property	Type	Description
id	string	The unique identifier for the post.
title	string	The title of the post.
slug	string	The URL-safe identifier for the post.
lede	string	The introductory content or summary of the post.
blocks	array of blocks	Content blocks that make up the post’s body.
publishDate	string	The date and time when the post was published.
blog	string	The blog this post belongs to.
authors	array of string	A list of authors associated with the post.
categories	array of string	Categories that classify the post.
tags	array of string	Tags for further categorization and searchability.
image	object	Main image associated with the post.
meta	object	SEO metadata, including title, description, and image.
createdAt	string	Timestamp when the post was created.
updatedAt	string	Timestamp when the post was last updated.

---

tag object

A tag entity in Basker CMS, used to classify and organize content.

Property	Type	Description
id	string	The unique identifier for the tag in Basker CMS.
title	string	The title or name of the tag.
slug	string	The unique, URL-safe identifier for the tag.
editSlug	boolean	Whether the slug can be edited or not.
tenant	string	The tenant that owns the tag.
updatedAt	string	Timestamp of the last update to the tag.
createdAt	string	Timestamp when the tag was created.

---

category object

A category entity in Basker CMS, representing hierarchical content grouping.

Property	Type	Description
id	string	The unique identifier for the category in Basker CMS.
title	string	The title or name of the category.
slug	string	The unique, URL-safe identifier for the category.
editSlug	boolean	Whether the slug can be edited or not.
parent	string	The parent category, if applicable.
breadcrumbs	array of object	Navigation breadcrumbs for the category, including doc, label, and url.
updatedAt	string	Timestamp of the last update to the category.
createdAt	string	Timestamp when the category was created.

---

author object

An author entity in Basker CMS, representing contributors or content creators.

Property	Type	Description
id	string	The unique identifier for the author in Basker CMS.
firstName	string	The first name of the author.
lastName	string	The last name of the author.
fullName	string	The full name of the author, typically auto-generated.
slug	string	The unique, URL-safe identifier for the author.
editSlug	boolean	Whether the slug can be edited or not.
tenant	string	The tenant associated with the author.
updatedAt	string	Timestamp of the last update to the author.
createdAt	string	Timestamp when the author was created.

---

redirect object

A redirect entity in Basker CMS, used to map one URL to another.

Property	Type	Description
id	string	The unique identifier for the redirect.
from	string	The source URL path that triggers the redirect.
to	object	The target destination, either an internal link or custom URL.
to.type	string	Specifies the type of redirect: internal (reference) or custom.
to.reference	object	The referenced document for internal redirects (e.g., pages).
to.reference.value	object	The target document’s metadata, such as id, title, and slug.
createdAt	string	Timestamp when the redirect was created.
updatedAt	string	Timestamp when the redirect was last updated.

---

Media Model

media object

A media entity in Basker CMS, representing uploaded and managed media files, including images and videos.

media object

A media entity in Basker CMS, representing uploaded and managed media files, including images and videos.

Property	Type	Description
id	string	The unique identifier for the media.
title	string	The title or name of the media file.
filename	string	The name of the media file, including its extension.
prefix	string	The file storage prefix or folder path for the media.
mimeType	string	The MIME type of the media (e.g., image/jpeg, video/quicktime).
filesize	number	The file size in bytes.
width	number	The width of the media in pixels (applicable for images).
height	number	The height of the media in pixels (applicable for images).
focalX	number	The X-coordinate percentage for the focal point (default is 50, applicable for images).
focalY	number	The Y-coordinate percentage for the focal point (default is 50, applicable for images).
sizes	object	Variants of the image at specific sizes, including thumbnail and opengraph (applicable for images).
alt	string	Alternative text for the media, used for accessibility.
caption	string	A caption describing the media.
credit	string	Credit information for the media, such as the photographer’s name.
tags	array of object	Tags associated with the media for categorization.
url	string	The full URL path to the media resource.
createdAt	string	Timestamp when the media was created.
updatedAt	string	Timestamp when the media was last updated.

---

file object

A file entity in Basker CMS, representing uploaded and managed generic files such as PDFs or documents.

Property	Type	Description
id	string	The unique identifier for the file.
title	string	The title or name of the file.
filename	string	The name of the file, including its extension.
prefix	string	The file storage prefix or folder path for the file.
mimeType	string	The MIME type of the file (e.g., application/pdf).
filesize	number	The file size in bytes.
url	string	The full URL path to the file resource.
tenant	object	Metadata related to the tenant that uploaded the file.
createdAt	string	Timestamp when the file was created.
updatedAt	string	Timestamp when the file was last updated.

---

media-tags object

A media tag entity in Basker CMS, used for categorizing and tagging media assets.

Property	Type	Description
id	string	The unique identifier for the media tag.
title	string	The title or name of the media tag.
slug	string	The unique, URL-safe identifier for the media tag.
tenant	string	The tenant that owns the media tag.
updatedAt	string	Timestamp of the last update to the media tag.
createdAt	string	Timestamp when the media tag was created.

---