Skip to main content
Dittofeed comes with a number of built-in liquid tags, filters. These are available to use in your templates. These serve as useful utility functions for rendering messages.

Tags

The unsubscribe_link tag outputs a link to unsubscribe from the message’s subscription group.
This renders a link of the form,
This tag is only usable in templates used within a journey message node that has been assigned a subscription group, and will otherwise produce an empty href. The link’s text can also be overridden by passing a parameter to the tag e.g.
Including an unsubscribe_link is critical for marketing emails, for both legal and user experience reasons. It should be included in the footer of your email, along with your company name, and address e.g.

unsubscribe_url

If you need to customize the unsubscribe link, you can use the unsubscribe_url tag to only output the URL.
The subscription_management_link tag outputs a link to the subscription management page without automatically unsubscribing the user. This allows users to manage their subscription preferences manually.
This renders a link of the form,
The link’s text can also be overridden by passing a parameter to the tag e.g.
This tag is useful when you want to provide users with access to subscription management without automatically changing their subscription status upon page load.

Channel Display Behavior

The subscription management page accessed via this link will always show subscription groups for all channels, allowing users to comprehensively manage their preferences across email, SMS, and other messaging channels.

subscription_management_url

If you need to customize the subscription management link, you can use the subscription_management_url tag to only output the URL.
This tag follows the same channel display behavior as subscription_management_link - always showing subscription groups for all channels.

view_in_browser_url

The view_in_browser_url tag outputs a URL that allows recipients to view the email in their web browser. This is useful for users whose email clients may not render the email correctly.
This renders a URL that can be used in a link:
This feature requires blob storage to be enabled. The rendered email HTML is stored in blob storage when the message is sent, and the URL provides secure access to view it.
Example usage in an email header:
For more details, see the View in Browser guide.

subscription_hidden_fields

The subscription_hidden_fields tag outputs the hidden form fields required for subscription management page form submissions. This tag is only available in custom subscription management page templates.
This renders hidden inputs for:
  • w - Workspace ID
  • h - Cryptographic hash for authentication
  • i - User identifier value
  • ik - Identifier key (e.g., email, userId)
  • isPreview - Preview mode flag (if applicable)
Example usage in a form:
This tag is required for form submission to work correctly. Without it, the subscription management page cannot authenticate or identify the user. See Custom Subscription Management Page for full documentation.