clear

Explicitly removes variables from memory to help garbage collection. Use this tag to free up memory after processing large arrays or objects that are no longer needed.

{% json products %}
  [
    { "id": 1, "title": "Product 1" },
    { "id": 2, "title": "Product 2" },
    { "id": 3, "title": "Product 3" }
  ]
{% endjson %}

{% assign product_titles = products | map: "title" %}

{% comment %} Process the data... {% endcomment %}
{% log product_titles %}

{% comment %} Clear variables when no longer needed {% endcomment %}
{% clear products, product_titles %}

{% comment %} Variables are now removed from memory {% endcomment %}
{% log products %}

Results in following output:

["Product 1", "Product 2", "Product 3"]
null

Syntax

{% clear variable_name %}
{% clear var1, var2, var3 %}

Parameter	Description
variable_name	Name of the variable to clear
var1, var2, ...	Multiple comma-separated variable names

Use Cases

After processing large CSV files:

{% assign all_rows = file_content | split: "\n" %}
{% assign parsed_data = all_rows | parse_csv %}

{% comment %} Process parsed_data... {% endcomment %}

{% clear file_content, all_rows %}

After GraphQL pagination:

{% assign all_products = "[]" | parse %}

{% for page in (1..10) %}
  {% graphql query:products_query as page_result %}
  {% assign all_products = all_products | concat: page_result.products.edges %}
  {% clear page_result %}
{% endfor %}

End of script cleanup:

{% comment %} Clear all large variables before script ends {% endcomment %}
{% clear ALL_PARSED_PRODUCT, ALL_EXIST_SKU, IMPORT_FILES, LOCAL_FILES %}

Notes

• Removes variables from all scopes (local and global)

• Sets variable to null before deletion to assist garbage collection

• No error is thrown if variable doesn't exist

• Useful for long-running scripts that process large datasets