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:

Returns a unique ID dynamically generated by Shopify.


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


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


<img  src="//" alt="New season - Spring 2017">


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.


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 %}