The block object

A block represents the content and settings of a single block in an array of section blocks. The block object can be accessed in a section file by looping through section.blocks.

{% for block in section.blocks %}
  <!-- output block content -->
{% endfor %}

The block object has the following attributes:

block.id

Returns a unique ID dynamically generated by Shopify.

block.settings

Returns an object of the block settings set in the theme editor. Retrieve setting values by referencing the setting's unique id.

Input

<img src="{{ block.settings.image | img_url: '800x' }}" alt="{{ block.settings.image.alt }}" />

Output

<img  src="//cdn.shopify.com/.../promo-banner1_800x.jpg" alt="New season - Spring 2017">

block.shopify_attributes

Returns a string representing the block's attributes.

The theme editor's JavaScript API uses a block's shopify_attributes to identify blocks and listen for events. No value for block.shopify_attributes is returned outside the theme editor.

block.type

Returns the type defined in the block's schema. This is useful for displaying different markup based on the block.type.

{% for block in section.blocks %}
  {% if block.type == 'advert' %}
    <!-- output an image with a link -->
  {% elsif block.type == 'headline' %}
    <!-- output a header with text -->
  {% endif %}
{% endfor %}

Want to discuss this page?

Visit the Shopify Community