Metadata Block


Metadata turns structured content fields into a compact, consistent summary. It is useful for author, publication date, reading time, tags and other fields that help visitors evaluate content before reading.


When to use Metadata

Use one Metadata block instead of typing author and date manually in a Text block. Values then stay connected to the current content item and follow one reusable visual pattern.


Choose the metadata items

Open Metadata Items and add only fields that help the reader. Typical article context includes author, publication date, reading time and Tags. Empty values are not useful, so populate the corresponding content fields first.


Organize groups and order

Arrange related fields together and place the most useful information first. Keep labels short and avoid repeating information that already appears prominently in the title or introduction.


Choose the variation

The variation defines how items are composed; columns control how many groups or fields share a row. Separator controls the visual break between inline values, and Avatar Size controls the author image when an avatar is included.


Prepare the source fields

Metadata can only render values that exist on the current content item. Add the author, effective date, reading time, Tags or schema-backed custom values in the content fields first, then select them in Metadata Items.


Configure and order fields


Open Fields in Metadata Properties and use + Add Field to add a supported value such as Custom field, Date, or Reading time. Configure Prefix, Suffix, or Format where available; use the arrow buttons to control display order and × to remove an item. These entries read values from the current content item, so populate the source fields first.

Metadata Settings showing Properties, variation, separator, and the Fields list.
Metadata Settings showing Custom field, Date, Reading time, and Advanced controls.


Properties and Style

Properties controls groups, item order, variation, columns, separators and avatar sizing. Style exposes Item and Container targets for typography, spacing, backgrounds, borders and effects.


Metadata Properties panel with metadata item settings in a clear retina documentation capture
Metadata Style Panel with responsive styling controls in a clear retina documentation capture


Tips & tricks

1. Show only information that helps visitors decide, orient or trust the content.

2. Keep the block compact and close to the title or introduction it describes.

3. Use a predictable field order across related article types.

4. Verify long author names, many tags and missing optional values.


Accessibility checklist

• Keep labels understandable without relying only on icons.

• Preserve readable contrast and a logical reading order when columns collapse.

• Use meaningful alternative text for author avatars when the image communicates identity.


Common mistakes

• Repeating the same date, author or category in several nearby blocks.

• Adding fields that are empty on most content items.

• Using too many columns for narrow screens.


Quick recipe

Populate the source fields, add the useful Metadata items, order them consistently, choose a compact variation, then verify wrapping and empty values at every breakpoint.

Questions, ideas, or bugs?

Explore what we’re building next, ask the Luna team for help, or send a focused bug report.