Pushes

Displays some images cards in column. Alignment and button are available

Frontmatter

blocks:
  - type: pushes
    heading: {} # (optional)
      surtitle: '' # string (optional)
      title: '' # string (optional)
      text: '' # markdown (optional)
    items: []
      surtitle: '' # string (optional)
      title: '' # string (optional)
      text: '' # markdown (optional)
      cta: {} # (optional)
        text: '' # string
        url: '' # url
        blank: false # boolean (optional)
        lang: '' # code lang, sets the hreflang attribute (optional)
      image: {} # (optional)
        src: '' # url
        filter: '' # [Box, Lanczos, CatmullRom, Linear] (optional)
        alt: '' # string (optional)
      video: {} # (optional, takes precedence over image)
        mp4: '' # url (optional)
        webm: '' # url (optional)
      ui: {} # (optional)
        offset: '' # [start, center, end] (optional)
        align: '' # [start, center, end] (optional)
        vertical_align: '' # [start, center, end] (optional)
        card: false # boolean, wraps the content in a card (optional)
        darken: false # boolean, darkens the media under the text (optional)
        background_color: '' # color (optional)
        color: '' # color (optional)
    ui: {} # (optional)
      theme: '' # [accent, black, dark, highlight, light, neutral, white] (optional)
      grid: '' # [xsmall, small, medium, large, container, full] (optional)
      offset: '' # [start, center, end] (optional)
      align: '' # [start, center, end] (optional)
      column: 1 # [1, 2] columns per row on desktop, grid layout only (optional)
      scrollsnap: '' # [none, sm, md, lg, xl, all] or object (optional)
      layout: '' # [grid, carousel] (optional)
      carousel: {} # only with layout: carousel (optional)

Each item carries its own ui object, the same way the block does. The keys at the item root are the legacy form and act as the fallback, so card: true next to title still works.

A single item is rendered on its own, without the items grid.

See Common keys for heading, footing, scrollsnap, carousel and the full ui reference.

Params

/config/_default/params.yaml

Mobile image width, when the default container width does not suit.

params:
  blocks:
    pushes:
      mobile: 336 # number, in pixels
Demo visual renderer

Files

CMS availability

CMSHugolify Admin v2
CloudCannonAvailable
Decap CMSAvailable
Netlify CMSAvailable
Pages CMSAvailable
Static CMSAvailable
Sveltia CMSAvailable
Tina CMSAvailable

The CMS writes an item’s appearance at the item root, the legacy form the theme still reads. align, vertical_align and the item video have no field yet and are set in the front matter.