Working with widgets

Widgets are the mechanism by which content is added to a page. Several varieties of widgets are available, each suitable for a different type of content. New widgets will become available over time.

Common widget datadef elements

Datadef elementDescription
... > Heading > Type

Indicates how the widget heading is treated.

  • text - the heading is treated as plain text.
  • link - the heading is treated as a link.
  • hidden - the heading is omitted entirely (both structurally and visually).
... > Heading > Style

Only appears when 'Type' is set to 'text' or 'link'

This option applies alternate heading sytles to the heading text without violating proper document structure.

  • default - no special styles applied
  • h1 - makes the widget heading appear as an h1 heading (largest)
  • h2 - makes the widget heading appear as an h2 heading
  • h3 - makes the widget heading appear as an h3 heading
  • h4 - makes the widget heading appear as an h4 heading
  • h5 - makes the widget heading appear as an h5 heading
  • h6 - makes the widget heading appear as an h6 heading (smallest)
... > Heading > Text

Appears when...

  • 'Type' is set to 'text'.
  • 'Type' is set to 'link' and the link option 'Auto-generate link text' is set to 'no'.

This is the text to be used as the widget heading.

... > Heading > Set internationalization

Appears when...

  • 'Type' is set to 'text'.
  • 'Type' is set to 'link' and the link option 'Auto-generate link text' is set to 'no'.

Used to apply internationalization to the heading. Refer to 'Internationalization'.

... > Heading > LinkThe link to apply to the heading. Refer to 'Working with links'.
... > TypeIndicates the type of widget. Refer to the 'Available widgets' section of this page.

Note

While there is no limit to the number of widgets you can assign to a row, for best results the total widget width should not exceed the width of the container. Examples of configuration that follow this recommendation include (but are not limited to) the following:

  • Four quarter-width widgets in a row
  • One two-thirds-width widget and one one-third-width widget in a row
  • One full-width widget in a row
  • One one-third-widget and one half-width widget in a row

Examples of potentially problematic configurations include (but are not limited to) the following:

  • One third-width widget and three quarter-width widgets in a row
  • Three half-width widgets in a row

Available widgets

Upcoming widgets

Can't find a widget that meets your content or design needs? Check our template roadmap to see what's planned for future enhancements.