Object Syntax

In several places within Craft and Sprout plugins, you are able to customize a setting with a dynamic value. For lack of a better term, we refer to this as Object Syntax and this documentation page aims to serve as a general guide.

TIP

You'll run into Object Syntax in Sprout Email as you Personalize your Email Templates.

In Craft you can use Object Syntax in the Entry URI Format field of your Section's Site Settings and the Title Format setting of your Entry Types.

In each of these scenarios we can think of the settings field as a mini Twig template. Settings that allow for Object Syntax will be parsed like a Twig template and, just like a Twig template, they may have some variables available to them for you to use (like an individual Entry page has the entry variable available).

Below we'll look at a comparison of how Craft processes templates and settings that support Object Syntax.

# Entry Pages

When you setup a Section with URLs, Craft makes an entry variable available to the Entry Template you define in the settings (such as news/_entry). In this case, you can then access your entry object and all of it's available properties in your entry template:

# news/_entry.twig

{{ entry.title }}
{{ entry.slug }}

In this example, our Template and Variables are processed and create our page.

Template Variables Output
news/_entry.twig entry news/my-page

# Title Format

When you setup an Entry Type, you can choose to not display the Title Field and generate your Title using the Title Format setting.

While this is a setting in the Control Panel, a very similar thing is happening as we have seen in the templates. Rather than a file being used as the Twig template (news/_entry.twig), the value of the Title Format setting is being used as the template.

When an Entry Element is saved, Craft makes the Entry Element available to that setting to allow the Title Format setting to use any property on the Entry Object when the Title is saved. While Craft gives you access to an Entry Element in the Title Format Setting, the variable is not named entry – it is named object.

{{ object.title }}
{{ object.slug }}

In this example, our Template and Variables are processed and create our Title.

Template Variables Output
Title Format Setting object Entry Title

TIP

Why does Craft name the variable object instead of something more appropriate like entry?

Object Syntax is supported by many different Elements and Settings within Craft and within plugins. As all of these features use the same code behind the scenes, Craft named the variable that gets created something generic so that it could apply to many scenarios.

# Shorthand Syntax

If you have a simple scenario, Object Syntax allows you to use a Shorthand Syntax as well.

Object Syntax Shorthand Syntax
{{ object.title }} {title}
{{ object.customField }} {customField}
{% if object.customField is not empty %}{{ object.title }}{% endif %} {% if object.customField is not empty %}{title}{% endif %}

TIP

Use Object Syntax in conditional logic like an if statement.

Last Updated: 11/23/2023, 10:32:53 PM