Receive email alerts when inventory levels change, with Mechanic.

Mechanic is a development and ecommerce automation platform for Shopify. :)

Receive email alerts when inventory levels change

Use this task to receive immediate email notifications whenever inventory/stock levels are adjusted, whether manually or as a result of a transfer or customer order.

Runs Occurs whenever an inventory level is updated and Occurs whenever an inventory level is connected. Configuration includes email recipient, email subject, and email body.

15-day free trial – unlimited tasks

Documentation

Use this task to receive immediate email notifications whenever inventory/stock levels are adjusted, whether manually or as a result of a transfer or customer order.

Please note: Mechanic will start sending emails the second time inventory is adjusted for a particular item.

The following "replacement" variables are defined in the task code for usage within the email subject and body. If you wish to include any other additional information, then you will either need to modify the task code to create additional variables, or use a GraphQL query directly in the task option field.
- AVAILABLE
- DIFFERENCE
- INVENTORY_HISTORY_LINK
- LOCATION_NAME
- MANAGE_VARIANT_LINK
- SKU
- TITLE

Developer details

Mechanic is designed to benefit everybody: merchants, customers, developers, agencies, Shopifolks, everybody.

That’s why we make it easy to configure automation without code, why we make it easy to tweak the underlying code once tasks are installed, and why we publish it all here for everyone to learn from.

(By the way, have you seen our documentation? Have you joined the Slack community?)

Open source
View on GitHub to contribute to this task
Subscriptions
shopify/inventory_levels/update
shopify/inventory_levels/connect
Tasks use subscriptions to sign up for specific kinds of events. Learn more
Options
email recipient (email, required), email subject (required), email body (required, multiline)
Code
{% assign email_recipient = options.email_recipient__email_required %}
{% assign email_subject = options.email_subject__required %}
{% assign email_body = options.email_body__required_multiline %}

{% if event.preview %}
  {% capture inventory_level_json %}
    {
      "inventory_item_id": 1234567890,
      "location_id": 1234567890,
      "available": 5,
      "admin_graphql_api_id": "gid://shopify/InventoryLevel/1234567890?inventory_item_id=1234567890"
    }
  {% endcapture %}

  {% assign inventory_level = inventory_level_json | parse_json %}
{% endif %}

{% assign cache_key = "inventory_level:" | append: inventory_level.inventory_item_id | append: "/" | append: inventory_level.location_id %}

{% assign previous_available = cache[cache_key] %}

{% if event.preview %}
  {% assign previous_available = 9 %}
{% endif %}

{% action "cache", "set", cache_key, inventory_level.available %}

{% if previous_available == blank %}
  {% break %}
{% endif %}

{% assign available_difference = inventory_level.available | minus: previous_available %}

{% if available_difference >= 0 %}
  {% assign available_difference = "+" | append: available_difference %}
{% endif %}

{% comment %}
  -- get additional data to be used in email content substitutions
{% endcomment %}

{% capture query %}
  query {
    inventoryLevel(id: {{ inventory_level.admin_graphql_api_id | json }}) {
      location {
        name
      }
      item {
        inventoryHistoryUrl
        sku
        variant {
          legacyResourceId
          displayName
          product {
            legacyResourceId
          }
        }
      }
    }
  }
{% endcapture %}

{% assign result = query | shopify %}

{% if event.preview %}
  {% capture result_json %}
    {
      "data": {
        "inventoryLevel": {
          "location": {
            "name": "Warehouse A"
          },
          "item": {
            "inventoryHistoryUrl": "https://preview-sample.myshopify.com/admin/products/inventory/1234567890/inventory_history",
            "sku": "WDGT123",
            "variant": {
              "legacyResourceId": "1234567890",
              "displayName": "Widget - Default Title",
              "product": {
                "legacyResourceId": "987654321"
              }
            }
          }
        }
      }
    }
  {% endcapture %}

  {% assign result = result_json | parse_json %}
{% endif %}

{% assign location_name = result.data.inventoryLevel.location.name %}
{% assign sku = result.data.inventoryLevel.item.sku %}
{% assign title = result.data.inventoryLevel.item.variant.displayName | remove: " - Default Title" %}
{% assign variant_id = result.data.inventoryLevel.item.variant.legacyResourceId %}
{% assign product_id = result.data.inventoryLevel.item.variant.product.legacyResourceId %}

{%- capture inventory_history_link -%}
  <a href="{{ result.data.inventoryLevel.item.inventoryHistoryUrl }}?location_id={{ inventory_level.location_id }}">View inventory history</a>
{%- endcapture -%}

{%- capture manage_variant_link -%}
  <a href="{{ shop.admin_url }}products/{{ product_id }}/variants/{{ variant_id }}">Manage this variant</a>
{%- endcapture -%}

{% assign email_subject
  = email_subject
  | replace: "DIFFERENCE", available_difference
  | replace: "SKU", sku
  | replace: "TITLE", title
%}

{% assign email_body
  = email_body
  | replace: "AVAILABLE", inventory_level.available
  | replace: "DIFFERENCE", available_difference
  | replace: "INVENTORY_HISTORY_LINK", inventory_history_link
  | replace: "LOCATION_NAME", location_name
  | replace: "MANAGE_VARIANT_LINK", manage_variant_link
%}

{% action "email" %}
  {
    "to": {{ email_recipient | json }},
    "subject": {{ email_subject | strip | json }},
    "body": {{ email_body | strip | newline_to_br | json }},
    "reply_to": {{ shop.customer_email | json }},
    "from_display_name": {{ shop.name | json }}
  }
{% endaction %}
Task code is written in Mechanic Liquid, an extension of open-source Liquid enhanced for automation. Learn more
Defaults
Email subject
DIFFERENCE inventory for SKU TITLE
Email body
Currently available inventory: AVAILABLE
Changed by: DIFFERENCE
Location: LOCATION_NAME

INVENTORY_HISTORY_LINK
MANAGE_VARIANT_LINK

Thanks,
{{ shop.name }}