Skip to content

Meta Properties

Meta properties can be used to extend functionality of Content and Containers in CEO, or to define a Channel in CEO's Custom Content system.

Either way, the functionality is the same.

Checkbox

Checkboxes provide a boolean value.

(string) [object].[checkboxLabel]

{% if not myEntry.myCheckbox %}
    do stuff
{% endif %}

Container

Container provides a linked CEO container.

(Container) [object].[containerLabel]

{% set myContainer = myEntry.myContainer %}
{% for item in myContainer.articles %}
    {{ item.headline }}
{% endfor %}

Date

Date provides a single date value without time. Dates are provided in ANSISQL format and can be parsed via the date filter. Please note that all dates are stored as UTC and converted to site's local timezone automatically.

(DateTime) [object].[dateLabel]

{{ myEntry.myDate }} # 2020-12-31
{{ myEntry.myDate|date('m/d/Y') }} # 12/31/2020

Datetime

Datetime provides a single date and time value. Datetimes are provided in ANSISQL format and can be parsed via the date filter. Please note that all dates are stored as UTC and converted to site's local timezone automatically.

(Datetime) [object].[datetimeLabel]

{{ myEntry.myDatetime }} # 2020-12-31 15:01:01
{{ myEntry.myDatetime|date('g:ia') }} # 3:01pm

Dropdown provides a single value from a predefined list. Note that the template value provides only the selected option, not the entire option list.

(string) [object].[dropdownLabel]

{{ myEntry.myDropdown }} # Some choice

Editortext

Editortext provides a code editor on the CEO interface. The resulting template value is simply plain text.

(string) [object].[editorTextLabel]

{{ myEntry.myEditorText }}

File

File provides the path to an uploaded file. Files are not processed through Imgix.

(object) [object].[fileLabel]

File object contains the following properties:

  • name - string file name
  • basename - string file name without extension
  • extension - string file extension
  • uuid - string file's UUID
  • source - string full public URL to file
<a href="{{ myEntry.myFile.source }}">Download {{ myEntry.myFile.name }}</a>

Group

A group is a special meta meta property which other meta properties.

(object) [object].[groupLabel]

There are two types of groups:

  • Unbounded groups
  • Bounded groups

Unbounded groups have no defined fields in CEO:

{% for label, prop in myEntry.myGroupedFiles %}
    {{ label }} - <a href="{{ prop.source }}">Download {{ prop.name }}</a>
{% endfor %}

{% for label, prop in myEntry.myGroupedDates %}
    {{ label }} - {{ prop|date('g:ia') }}
{% endfor %}

Bounded groups have defined fields in CEO and can be iterated over or referenced as their labels:

{% for label, prop in myEntry.myGroupedFiles %}
    {{ label }} - <a href="{{ prop.source }}">Download {{ prop.name }}</a>
{% endfor %}

{{ myEntry.myGroupedDates['Start Date']|date('g:ia') }}

Location

Full address and geolocation data.

(object) [object].[locationLabel]

Location object contains the following properties:

  • addr1 - string Address line one
  • addr2 - string Address line two
  • city - string City value
  • state - string State value
  • zip - string Zip-code value
  • coords - array
    • lat - float Latitude
    • lng - float Longitude
<address>
{{ myEntry.myLocation.addr1 }}<br />
{{ myEntry.myLocation.addr2 }}<br />
{{ myEntry.myLocation.city }}, {{ myEntry.myLocation.state }}<br />
<img src="[static maps url]?lat={{ myEntry.myLocation.coords.lat|e }}&lng={{ myEntry.myLocation.coords.lng|e }}" />

Longtext

A larger, multiline text box.

(string) [object].[longtextLabel]

{{ myEntry.myLongtext }}

Number

An integer or float

(int|float) [object].[numberLabel]

{{ myEntry.myNumber }}

Relatedcontent

Multiple related CEO Content objects. Keep in mind that related items may be of any content type:

  • article
  • media
  • page

Also they are CEO objects and extended by compatibility wrappers by default, though you can call toCompat() on them.

(Collection) [object].[relatedContentLabel]

{% for item in myEntry.myRelatedContent %}
    <a href="{{ item.getFriendlyUrl }}">{{ item.headline }}</a>
{% endfor %}

Relatedentries

Multiple related CEO Entry objects.

(Collection) [object].[relatedEntriesLabel]

{% for item in myEntry.myRelatedEntries %}
    {{ item.myTextLabel }}
{% endfor %}

Richtext

Rich editor text, provided by CEOEdit2. Please note that text may contain formatting and embedded items.

(string) [object].[richTextLabel]

{{ myEntry.myRichText }}
{{ myEntry.myRichText|raw }}
{{ myEntry.myRichText|e('embeds')|raw }}

Securetext

Secure text items are at rest encrypted string values. Once created, secure text items are not readable from within CEO. This meta property is not cyptographically secure and MUST not be used to store sensitive data.

(string) [object].[secureTextLabel]

{{ myEntry.mySecureText }}

Selectentry

Similar to Relatedentries, but limited to a single entry.

(Entry) [object].[selectEntryLabel]

{{ myEntry.mySelectedEntry.title }}

Text

Plain, single line text.

(string) [object].[textLabel]

{{ myEntry.myText }}