Creating Social Posts with Liquid

Jepto leverages the Liquid template language syntax in creating social posts.

Which allows you to create dynamic content with variables, profile fields and conditional logic, ensuring that posts are tailored to each specific profile, enhancing personalization and engagement.

‍

1. Liquid Format

The liquid language uses curly braces with a percentage symbol at the start and end of any content, like this: {% %}.

Items in curly brace percentage delimiters that contain statements such as a if need to have a terminating statement to be valid. That is, a statement beginning {% if …​} will need to have a terminating statement such as {% endif %} located where you want the if condition to end.

If you start writing a condition that is contained in curly brace percentage delimiters and you add a variable or profile field to the statement, it will be inserted contained within double curly braces. You’ll need to delete this set of double curly braces.

For example adding a profile field or variable into the text editor within {% if %}

will result in

🔴 {% if {{ profile.city }} == 'Sydney' %}

which won’t be valid. So remove the double curly braces to complete the statement

🟢 {% if profile.city == 'Sydney' %}

‍

Operators

Liquid includes many logical and comparison operators. You can use operators to create logic with control flow tags.

‍

Control Flow

Control flow tags determine when blocks of Liquid code are executed. Jepto supports the following sets of control flow tags, as stated in the Liquid documentation:

• if, elsif, else, and endif
• unless and endunless
• case, when, else, and endcase

2. Dynamic Content

There are two types of supported dynamic content, the pre-populated Profile fields and custom variables. Any text that is enclosed in double curly braces, {{ }} will be evaluated for dynamic content. In order to create your logic with liquid you will use profile fields and variables for your conditional statements.

Profile Fields

Begin with the prefix of profile. For example {{ profile.name }} would be used to create a dynamic post that inserts the Profile Name. When posting to a social platform the system automatically inserts the Profile Name for each profile it's posted to. If a profile does not have this field filled in, you can set a default value to be used instead. Example: {{ profile.name | default: 'ACME Toys' }}.‍

‍

Variables

Begin with the prefix of variable and the name is defined by you when they are created.

For example {{ variable.marketingName }} would be used for the variable 'Marketing Name'. To insert the variable you can use the button and see example values before inserting it into the text box. You will also be asked to provide a fallback value so that you don't need to learn the liquid syntax. For example, this would insert the 'Marketing Name' variable with the fallback of "Local Store". {{ variable.marketingName | default: 'Local Store' }}.

‍

3. Using Liquid and dynamic content to create a post

Let's put both liquid and dynamic content together to create a post about a promotion where the discount values are different for various cities and states in a national campaign.

‍

You can achieve the above logic in a couple of different ways, which we will demonstrate with conditional statements in Liquid:

1. Using if, elsif, and else

This method is used for simple conditional statements.

Enjoy a special discount at Homer's Donuts!
{% if profile.city == 'Sydney' %} Get 20% OFF your order!
{% elsif profile.state == 'Queensland' %} Get 10% OFF your order! 
{% elsif profile.region == 'Perth' %} Get 15% OFF your order!
{% else %} Get 5% OFF your order! {% endif %}

‍

2. Using case, when, else, and endcase

Used as an alternative to simple if statements and for complex conditional statements with multiple conditions, as its a more readable alternative to nested if statements.

Enjoy a special discount at Homer's Donuts!
{% case true %}
 {% when profile.city == 'Sydney' %} Get 20% OFF your order!
 {% when profile.state == 'Queensland' %} Get 10% OFF your order!
 {% when profile.region == 'Perth' %} Get 15% OFF your order!
 {% else %} Get 5% OFF your order!
{% endcase %}

‍

3. Using unless and endunless

Use this for negative conditional statements, where you only want to customise content if the condition is false. This example is different to the above and will display "Get 5% OFF your order!" unless the profile is in Sydney.

{% unless profile.state == 'Sydney' %}
    Get 5% OFF your order!
{% endunless %}