Skip to content

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.

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.

{{ event.title }}

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.

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

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

An event in Basker.

PropertyTypeDescription
idstringThe unique identifier for the Event in Basker CMS.
titlestringThe name or title of the Event.
descriptionstringA short description of the event.
imageobjectThe main image associated with the event.
slugstringThe unique, URL-safe identifier for the event.
venuevenueThe venue associated with the event. Includes id and name.
companyorganizationThe production company name, if specified.
startDatestringThe start date of the event.
endDatestringThe end date of the event.
durationnumberThe duration of the event in minutes, if provided.
workworkA reference to the work being performed.
seasonseasonThe associated season with id and title (e.g., “2024/25 Season”).
seriesseriesA series to which the event belongs, if specified.
participantsarray of person groupsGroups of participants, such as cast or crew, with name, role, and id.
blocksarray of blocksA dynamic array of content blocks. Depends on the theme configuration.
mediaarray of mediaMedia assets, including images or videos linked to the event.
instancesarray of event_instanceEvent performance instances with individual dates and times.
customAttributesobjectUser-defined custom attributes for the event.
themeobjectDeveloper-defined theme fields for the theme.
metaobjectSEO metadata for the event. Includes title, description, and image.
updatedAtstringTimestamp of the last update.
createdAtstringTimestamp of when the event was created.

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

PropertyTypeDescription
idstringThe unique identifier for the Event Instance in Basker CMS.
eventeventThe parent event details associated with this instance. Includes id.
startDatestringThe start date and time of the event instance.
endDatestringThe end date and time of the event instance, if specified.
venuevenueThe venue where the instance occurs. Includes id and name.
companystringThe production company name for this instance, if overridden.
workstringA reference to the work being performed, if overridden.
seriesarrayAn array of series this instance belongs to. Includes title and id.
participantsarray of personA list of participants (e.g., cast or crew) specific to this instance.
customAttributesobjectCustom user-defined attributes specific to this instance.
updatedAtstringTimestamp of the last update to the event instance.
createdAtstringTimestamp of when the event instance was created.

A person entity in Basker CMS.

PropertyTypeDescription
idstringThe unique identifier for the person in Basker CMS.
namestringThe full name of the person.
firstNamestringThe first name of the person.
lastNamestringThe last name of the person.
pronounsstringPronouns associated with the person, e.g., he/him/his.
biography_htmlhtmlThe person’s biography rendered as HTML
slugstringThe unique, URL-safe identifier for the person.
imagemediaImage object associated with the person. Includes url, filename, and dimensions.
blocksarray of blocksA dynamic array of content blocks related to the person.
attributesobjectCustom attributes for the person.
createdAtstringTimestamp when the person was created.
updatedAtstringTimestamp when the person was last updated.

A season entity in Basker CMS.

PropertyTypeDescription
idstringThe unique identifier for the season in Basker CMS.
titlestringThe title of the season.
descriptionstringThe description of the season.
slugstringThe unique, URL-safe identifier for the season.
startDatestringThe start date of the season in ISO 8601 format.
endDatestringThe end date of the season in ISO 8601 format.
descriptionstringA description of the season, if available.
eventsarray of eventsAn array of event IDs associated with this season.
blocksarray of blocksA dynamic array of content blocks related to the season.
attributesobjectCustom attributes for the season.
createdAtstringTimestamp when the season was created.
updatedAtstringTimestamp when the season was last updated.

A series entity in Basker CMS.

PropertyTypeDescription
idstringThe unique identifier for the series in Basker CMS.
titlestringThe title of the series.
descriptionstringThe description of the series.
slugstringThe unique, URL-safe identifier for the series.
descriptionstringA description of the series, if available.
startDatestringThe start date of the series in ISO 8601 format.
endDatestringThe end date of the series in ISO 8601 format.
eventsarray of eventsAn array of events associated with this series. Includes event IDs.
instancesarray of event_instanceAn array of event instances tied to the series.
blocksarray of blocksA dynamic array of content blocks related to the series.
attributesobjectCustom attributes for the series.
createdAtstringTimestamp when the series was created.
updatedAtstringTimestamp when the series was last updated.

A creative work entity in Basker CMS.

PropertyTypeDescription
idstringThe unique identifier for the work in Basker CMS.
titlestringThe title of the work.
descriptionstringThe description of the creative work.
slugstringThe unique, URL-safe identifier for the work.
descriptionstringA description of the work, if available.
authorstringThe author or creator of the work. Referenced via ID.
firstPerformedDatestringThe date when the work was first performed.
blocksarray of blocksA dynamic array of content blocks related to the work.
attributesobjectCustom attributes for the work, such as metadata (e.g., author).
createdAtstringTimestamp when the work was created.
updatedAtstringTimestamp when the work was last updated.

A venue entity in Basker CMS.

PropertyTypeDescription
idstringThe unique identifier for the venue in Basker CMS.
namestringThe name of the venue.
descriptionstringThe description of the venue.
slugstringThe unique, URL-safe identifier for the venue.
countrystringThe country where the venue is located (ISO Alpha-2 code).
addressLine1stringThe first line of the venue’s address.
addressLine2stringThe second line of the venue’s address, if applicable.
citystringThe city where the venue is located.
statestringThe state or region where the venue is located.
postalCodestringThe postal or ZIP code of the venue.
blocksarray of blocksA dynamic array of content blocks related to the venue.
attributesobjectCustom attributes for the venue.
createdAtstringTimestamp when the venue was created.
updatedAtstringTimestamp when the venue was last updated.

An organization entity in Basker CMS.

PropertyTypeDescription
idstringThe unique identifier for the organization in Basker CMS.
namestringThe name of the organization.
slugstringThe unique, URL-safe identifier for the organization.
descriptionstringA description of the organization, if provided.
typestringThe type or category of the organization, if specified.
blocksarray of blocksA dynamic array of content blocks related to the organization.
attributesobjectCustom attributes for the organization.
createdAtstringTimestamp when the organization was created.
updatedAtstringTimestamp when the organization was last updated.

A page entity in Basker CMS.

PropertyTypeDescription
idstringThe unique identifier for the page in Basker CMS.
titlestringThe title of the page.
slugstringThe unique, URL-safe identifier for the page.
blocksarray of blocksA dynamic array of content blocks on the page.
metaobjectSEO meta information including title and description.
breadcrumbsarray of objectNavigation breadcrumbs for the page. Includes label and url.
parentstringThe parent page, if applicable.
sortnumberThe sort order of the page relative to other pages.
themeobjectTheme data applied to the page, if any.
createdAtstringTimestamp when the page was created.
updatedAtstringTimestamp when the page was last updated.

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

PropertyTypeDescription
idstringThe unique identifier for the theme in Basker CMS.
namestringThe name of the theme.
descriptionstringA brief description of the theme, if provided.
authorstringThe author of the theme.
versionstringThe version number of the theme.
settingsobjectA collection of customizable theme settings such as colors, social links, and logo.
manifestobjectThe theme manifest containing templates, layouts, and block schemas.
filenamestringThe uploaded theme file name.
mimeTypestringThe MIME type of the theme file.
filesizenumberThe size of the theme file in bytes.
urlstringThe URL to download the theme file.
createdAtstringTimestamp when the theme was created.
updatedAtstringTimestamp when the theme was last updated.

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.

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

PropertyTypeDescription
idstringThe unique identifier for the collection.
titlestringThe title of the collection.
slugstringThe URL-safe identifier for the collection.
descriptionstringA textual description of the collection.
typestringThe type of collection: manual or automated.
conditionTypestringSpecifies whether all or any conditions are required for automation.
conditionsarray of objectAn array defining the conditions for automated collections.
sortstringSort order of entities, e.g., performDateAsc.
eventsarray of objectA list of events included in the collection.
metaobjectMetadata for SEO, including title, description, and image.
createdAtstringTimestamp when the collection was created.
updatedAtstringTimestamp when the collection was last updated.

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

PropertyTypeDescription
idstringThe unique identifier for the blog.
titlestringThe title of the blog.
slugstringThe URL-safe identifier for the blog.
metaobjectMetadata for SEO, including title, description, and image.
imageobjectThe main image associated with the blog.
createdAtstringTimestamp when the blog was created.
updatedAtstringTimestamp when the blog was last updated.

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

PropertyTypeDescription
idstringThe unique identifier for the post.
titlestringThe title of the post.
slugstringThe URL-safe identifier for the post.
ledestringThe introductory content or summary of the post.
blocksarray of blocksContent blocks that make up the post’s body.
publishDatestringThe date and time when the post was published.
blogstringThe blog this post belongs to.
authorsarray of stringA list of authors associated with the post.
categoriesarray of stringCategories that classify the post.
tagsarray of stringTags for further categorization and searchability.
imageobjectMain image associated with the post.
metaobjectSEO metadata, including title, description, and image.
createdAtstringTimestamp when the post was created.
updatedAtstringTimestamp when the post was last updated.

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

PropertyTypeDescription
idstringThe unique identifier for the tag in Basker CMS.
titlestringThe title or name of the tag.
slugstringThe unique, URL-safe identifier for the tag.
editSlugbooleanWhether the slug can be edited or not.
tenantstringThe tenant that owns the tag.
updatedAtstringTimestamp of the last update to the tag.
createdAtstringTimestamp when the tag was created.

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

PropertyTypeDescription
idstringThe unique identifier for the category in Basker CMS.
titlestringThe title or name of the category.
slugstringThe unique, URL-safe identifier for the category.
editSlugbooleanWhether the slug can be edited or not.
parentstringThe parent category, if applicable.
breadcrumbsarray of objectNavigation breadcrumbs for the category, including doc, label, and url.
updatedAtstringTimestamp of the last update to the category.
createdAtstringTimestamp when the category was created.

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

PropertyTypeDescription
idstringThe unique identifier for the author in Basker CMS.
firstNamestringThe first name of the author.
lastNamestringThe last name of the author.
fullNamestringThe full name of the author, typically auto-generated.
slugstringThe unique, URL-safe identifier for the author.
editSlugbooleanWhether the slug can be edited or not.
tenantstringThe tenant associated with the author.
updatedAtstringTimestamp of the last update to the author.
createdAtstringTimestamp when the author was created.

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

PropertyTypeDescription
idstringThe unique identifier for the redirect.
fromstringThe source URL path that triggers the redirect.
toobjectThe target destination, either an internal link or custom URL.
to.typestringSpecifies the type of redirect: internal (reference) or custom.
to.referenceobjectThe referenced document for internal redirects (e.g., pages).
to.reference.valueobjectThe target document’s metadata, such as id, title, and slug.
createdAtstringTimestamp when the redirect was created.
updatedAtstringTimestamp when the redirect was last updated.

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

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

PropertyTypeDescription
idstringThe unique identifier for the media.
titlestringThe title or name of the media file.
filenamestringThe name of the media file, including its extension.
prefixstringThe file storage prefix or folder path for the media.
mimeTypestringThe MIME type of the media (e.g., image/jpeg, video/quicktime).
filesizenumberThe file size in bytes.
widthnumberThe width of the media in pixels (applicable for images).
heightnumberThe height of the media in pixels (applicable for images).
focalXnumberThe X-coordinate percentage for the focal point (default is 50, applicable for images).
focalYnumberThe Y-coordinate percentage for the focal point (default is 50, applicable for images).
sizesobjectVariants of the image at specific sizes, including thumbnail and opengraph (applicable for images).
altstringAlternative text for the media, used for accessibility.
captionstringA caption describing the media.
creditstringCredit information for the media, such as the photographer’s name.
tagsarray of objectTags associated with the media for categorization.
urlstringThe full URL path to the media resource.
createdAtstringTimestamp when the media was created.
updatedAtstringTimestamp when the media was last updated.

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

PropertyTypeDescription
idstringThe unique identifier for the file.
titlestringThe title or name of the file.
filenamestringThe name of the file, including its extension.
prefixstringThe file storage prefix or folder path for the file.
mimeTypestringThe MIME type of the file (e.g., application/pdf).
filesizenumberThe file size in bytes.
urlstringThe full URL path to the file resource.
tenantobjectMetadata related to the tenant that uploaded the file.
createdAtstringTimestamp when the file was created.
updatedAtstringTimestamp when the file was last updated.

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

PropertyTypeDescription
idstringThe unique identifier for the media tag.
titlestringThe title or name of the media tag.
slugstringThe unique, URL-safe identifier for the media tag.
tenantstringThe tenant that owns the media tag.
updatedAtstringTimestamp of the last update to the media tag.
createdAtstringTimestamp when the media tag was created.