Examples & Combinations

Detailed Attribute Reference

layout

Controls the visual appearance of the events list.

list (default):

• Full-width cards
• Large featured image
• Full excerpt
• Category label
• "Read more" link
• Best for: main content areas, full pages

[herodotus layout="list"]

compact:

• Small square thumbnail (left-aligned)
• Short title and excerpt
• No category label
• No "Read more" button
• Best for: sidebars, widget areas, narrow columns

[herodotus layout="compact"]

limit

Restricts the number of events displayed.

[herodotus limit="3"]

If there are 10 events for today and you set limit="3", only the first 3 (after sorting) will be shown.

category

Filters events by a specific Herodotus category. Use the category slug (not the name).

[herodotus category="science"]

To find the slug: go to Herodotus → Categories and look at the "Slug" column.

excerpt_words

Controls how many words appear in the event excerpt.

[herodotus excerpt_words="20"]

This overrides the global setting for this specific shortcode instance.

show_image

When set to false, hides all images (including the default placeholder). Events display only title, excerpt and Read more.

[herodotus show_image="false"]

order

Overrides the global sort order for this shortcode instance.

[herodotus order="DESC"]

ASC = A → Z (alphabetical) | DESC = Z → A (reverse alphabetical)

Combining Attributes

All attributes can be combined freely:

[herodotus layout="compact" category="politics" limit="5" excerpt_words="10" show_image="false"]