Conditionally disable emails

Firmhouse supports a good range of transactional emails out of the box. While it’s great to have all these flows enabled for better customer communication, not everyone wants to support all the flows. Most Firmhouse emails have the option to be disabled via a toggle, while others are marked as mandatory and therefore cannot be disabled via the UI.

In some cases, you might want to prevent specific Firmhouse emails from being sent. For example:

• For a client’s first subscription order, you don’t want to send a subscription signup confirmation email alongside the order confirmation email
• You don’t want to send upcoming order emails to subscriptions with specific statuses, or who don’t meet the required minimum order value

Using the SKIP_EMAIL Tag

In cases like these, you can insert [SKIP_EMAIL] in the email body, which will prevent the email from sending.

For more complex cases, you can also insert [SKIP_EMAIL] conditionally using Liquid tags. For example, here’s how to skip emails for paused subscriptions:

{% if subscription.status == "paused" %} [SKIP_EMAIL] {% endif %}

Another use case is to skip sending the upcoming order email for subscribers who don’t meet the minimum order amount:

{% if !order.minimum_order_amount_reached? %} [SKIP_EMAIL] {% endif %}

Combining Conditions

Depending on the case, these conditions can be combined and other ones can be created. You can consult the Dynamic Email Liquid Tags to explore which attributes can be used for creating the conditional logic.