Events now offer longer, formatted, discursive text about an event in a listing.

The event definition in Cameo includes a formatted full description field. It supplements the summary description. Full and summary descriptions are analogous with a WordPress post and its excerpt.

Why full descriptions?

So far, Cameo makes use of the full description in two places:

As with email templates, you can insert images from your public website (or elsewhere), and even YouTube videos; and include links to performers’ web sites and the like.

The web site where it is embedded, or the email in which it is included, determines the formatting details such as font, link colour and so on.


There are a couple of specialised substitutions you can use in the event description. Usually, put these in a paragraph of their own (not inline in the text):

  • {DETAILS} – the date(s), time(s), prices and location of the event, as determined from other event information. Having this as a substitution lets you use your own house style: putting these at the top, bottom or elsewhere in the text. It avoids duplicating the information manually.
  • {BOOK} – a booking link (often styled as a button, as in the Junction example above). Again this gives you the choice of where this appears. The link target is configurable in the block options in WordPress.

Event name

Note the title does not need to be included in the text. The WordPress plugin will automatically replace the WordPress page title with the name of the event. In news builder, the name of the event will be substituted in the block’s headline.

Fig 1: an event definition showing the formatted description field used to provide the bulk of the text in the Event Listing block (as well as a summary and thumbnail, used in the Events Summary block)