Shopify notifications

Order has a subscription

Shows different content when a line item has a subscription. This matches any order with a subscription, including recurring ones, so keep the message neutral or combine it with the recurring check below. Use it to link to customer accounts, where the customer manages their subscription.

Email body

{% assign has_subscription = false %}
{% for line_item in line_items %}
  {% if line_item.selling_plan_allocation %}
    {% assign has_subscription = true %}
    {% break %}
  {% endif %}
{% endfor %}

{% if has_subscription %}
  <p>This order contains a subscription. <a href="{{ shop.url }}/account">Manage your subscription</a></p>
{% else %}
  <p>Thank you for your order</p>
{% endif %}

Recurring subscription order

Shows different content when the order is a recurring one. Recurring orders created by Supercycle carry a rental_id line item property. The original checkout order doesn’t.

Email body

{% assign is_recurring = false %}
{% for line_item in line_items %}
  {% for prop in line_item.properties %}
    {% if prop.first == 'rental_id' %}
      {% assign is_recurring = true %}
    {% endif %}
  {% endfor %}
{% endfor %}

{% if is_recurring %}
  <p>Thank you for your subscription order</p>
{% else %}
  <p>Thank you for your order</p>
{% endif %}

To change the subject too, paste this whole snippet, including the detection loop, into Email subject. It’s the same check written with {%- whitespace control so the subject renders on one line.

Email subject

{%- assign is_recurring = false -%}
{%- for line_item in line_items -%}
  {%- for prop in line_item.properties -%}
    {%- if prop.first == 'rental_id' -%}{%- assign is_recurring = true -%}{%- endif -%}
  {%- endfor -%}
{%- endfor -%}
{%- if is_recurring -%}
  Thanks for your subscription order, {{ customer.first_name }}
{%- else -%}
  Thanks for your order, {{ customer.first_name }}
{%- endif -%}

Don’t use order.source_name == 'subscription_contract' to detect recurring orders. Shopify has changed source_name values without notice, and initial checkout orders can match this condition too.

Rental start and end dates

Shows the start and end dates of the line items. It works best when every product has fixed dates on. Add it to Shopify’s default notifications to show the dates when your template doesn’t output line item properties.

Email body

{% assign start_date = '' %}
{% assign end_date = '' %}

{% for line_item in order.line_items %}
  {% for prop in line_item.properties %}
    {% if prop.first == 'Start date' %}
      {% assign start_date = prop.last %}
    {% elsif prop.first == 'End date' %}
      {% assign end_date = prop.last %}
    {% endif %}
  {% endfor %}
{% endfor %}

{% if start_date != '' %}
  <p><strong>Start date:</strong> {{ start_date }}</p>
{% endif %}
{% if end_date != '' %}
  <p><strong>End date:</strong> {{ end_date }}</p>
{% endif %}

Rental dates in staff notifications

Shows the rental dates for each product in a staff notification such as New order. Place it inside the line item loop, where line is each line item.

Line item loop

{%- assign rental_start_date = '' -%}
{%- assign rental_end_date = '' -%}
{%- for prop in line.properties -%}
  {%- if prop.first == 'Start date' -%}
    {%- assign rental_start_date = prop.last -%}
  {%- elsif prop.first == 'End date' -%}
    {%- assign rental_end_date = prop.last -%}
  {%- endif -%}
{%- endfor -%}
{%- if rental_start_date != '' or rental_end_date != '' -%}
  <p class="order-list__item-variant" style="margin-top: 4px;">
    <strong>Rental details</strong><br>
    {%- if rental_start_date != '' -%}
      Start date: {{ rental_start_date }}<br>
    {%- endif -%}
    {%- if rental_end_date != '' -%}
      End date: {{ rental_end_date }}
    {%- endif -%}
  </p>
{%- endif -%}

Order has a charge

Shows different content when the order is for a charge created in Supercycle rather than a normal order.

Email body

{% assign has_charge = false %}
{% assign charge_reason = '' %}

{% for line_item in order.line_items %}
  {% for prop in line_item.properties %}
    {% if prop.first == 'Charge' %}
      {% assign has_charge = true %}
      {% assign charge_reason = prop.last %}
    {% endif %}
  {% endfor %}
{% endfor %}

{% if has_charge %}
  <p>You have been charged: {{ charge_reason }} </p>
{% else %}
  <p>Thank you for your order</p>
{% endif %}

Overview

Setup

Methods

Manage

Sales channels

Configuration

Shopify notifications

Add a snippet to a template

Snippets

​Add a snippet to a template

​Snippets

Add a snippet to a template

Snippets