Liquid Raw Tag

Using Raw Tag

Liquid raw tag escapes Liquid delimiters in Shopify content.

Introduction to Liquid Raw Tag

The Liquid raw tag is a powerful tool in Shopify that allows developers to include Liquid code in content without it being processed. This is particularly useful when you want to display code snippets or example Liquid syntax within pages or blog posts.

When using Liquid in Shopify, any code within the standard delimiters like {{ ... }} or {% ... %} is processed by the Liquid template engine. However, there are situations where you need to prevent this processing, such as when documenting code. This is where the raw tag becomes invaluable.

Syntax of the Raw Tag

The syntax for the raw tag is straightforward. You simply wrap the Liquid code you want to escape within {% raw %} and {% endraw %} tags.

Use Cases for the Raw Tag

The raw tag is particularly useful in the following scenarios:

Documenting Liquid Code: When writing tutorials or documentation, you might need to show Liquid code examples without executing them.
Creating Code Examples: If you are building a blog or a help center where you want to display sample code to users, using the raw tag ensures that your examples remain intact.
Preventing Execution: In cases where you need to display Liquid code exactly as is, without any processing or execution.

Example: Displaying Liquid Code in a Blog

Let's say you are writing a blog post about how to use variables in Liquid. You want to show the readers the syntax without executing it. Here’s how you can use the raw tag:

Conclusion

The Liquid raw tag is an essential tool for developers working with Shopify, especially when the need arises to present Liquid code examples without execution. By understanding and utilizing the raw tag, you can ensure that your content is displayed exactly as intended, whether for educational purposes or simply to share knowledge with others.