Using Tokens, Editing Templates & Custom Coding

Heads Up!

Templates in Arigato Automation use Twig code, not Liquid code! They're really similar, but there are slight differences. More Twig info under Using Twig Syntax below.

Understanding Tokens, Loops & Functions

Some Actions in Arigato allow you to insert tokens, which represent the data available in the context of your workflow. For example, a product workflow will have product related tokens available to you, such as the product's name, or the product's tags.

Tokens vs. Loops vs. Functions

Some tokens represent a single dynamic value, such as a product title.

{{ product.title }}

Other times, the token browser will insert a code loop that allows you to access each item in a list, such as each variant on a product, or each line item in an order.

{% for variant in product.variants %}

{% endfor %}

In Arigato, we've also created a few functions for your convenience. Functions are a single line of code that, when evaluated in Arigato, will format an object in a certain way, saving you from tedious coding for common uses. An example of a function in Arigato is the product list function on an order. A call to this function will produce a complete product list with links and all common data points, for use in an email. See Functions below for more information.

Token Browser Example

The example below shows how to display a list of variant titles for a newly paid order workflow. The first step is to click on the token picker button:

Next, search for the variant title on the token picker, this will fall under "Line items":

Finally, click on the "Insert token" button as shown below:

Functions

There are some helpful built-in functions that make common formats more accessible. Functions have arguments that control how they work. For example, depending on whether you are sending an HTML email or a Slack message, the "html:true" argument will control whether the function renders HTML or as plain text. Each function is documented in the Token Browser with the arguments they accept.

The following example shows the "format_address()" function to format a complete address with street, company, city, state, and ZIP.

Using Twig Syntax

Twig is a templating engine (similar to Shopify's Liquid) that allows you to perform some basic string and array manipulation. Common uses are listed below. You may also read the Official Twig Documentation. See below for additional custom filters in Arigato Automation and filters that act similarly to Liquid.

Additional examples and references can be located in the Arigato app, under the Code Reference link.

Assigning Variables

{% set foo = "Bar" %}

For Loops

{% for item in array %} {{ item }} {% endfor %}

If Conditions

{% if some_value > 100 %}  {% endif %} {% if some_variable is not empty %}  {% endif %}

Split Strings

{% set tags = customer.tags|split(',') %}

Example Filters

{{ 9800.333 | number_format(2,'.',',') }} {{ order.created_at | date("F j, Y, g:i a - T") }} Example output: April 25, 2019, 2:17 pm - EDT

{{ "now" | date("m/d/Y") }}

View date formatter options.

{{ 'my first car'|capitalize }} Example output: My First Car {{ "I like %this% and %that%."| replace({'%this%':foo,'%that%':"bar"}) }}

Custom Filters in Arigato Automation

Twig does not natively provide a matching filter for all the Liquid filters you may be accustomed to. We've added support for these filters in Arigato Automation, and a few other handy filters. Note that Twig syntax is very similar but not identical to Liquid.

to_json

Converts any object or array to json. This is extremely handy when you need to dump all variables in an array to inspect them.

{{ order.line_items | to_json }}

from_json( $keyed_array: false )

Converts a JSON string into an object or keyed array.

{{ '{"num": 1}' | from_json.num }} // Prints "1" (object syntax) {% set json = '{"num": 1}' | from_json(true) %} {% set key = "num" %} {{ json[key] }} // Prints "1" (keyed array syntax)

to_handle

Convert any string into a handle.

{{ "my product title" | to_handle }}

strip_newlines

Removes any new line characters such as br tags or n tags.