Deprecated filters

The following Liquid filters are considered deprecated, and have been replaced. They are still used in some themes, but it's recommended that you use the alternatives that are listed below.

Color filters

The following color filters are now deprecated:


Theme settings return hexadecimal values for color settings by default. Use the hex_to_rgba filter to convert the value into RGBA. The default is an opacity of 1, however you can specify an opacity between 0 and 1. Shorthand hex values, like #812, are accepted as well.


.site-footer h1 {
  color: {{ settings.color_name }};

.site-footer p {
  color: {{ settings.color_name | hex_to_rgba: 0.5 }};


.site-footer h1 {
  color: #812dd3;

.site-footer p {
  color: rgba(129, 45, 211, 0.5);

HTML filters

The following HTML filters are now deprecated:


Generates a drop-down list that customers can use to select an accepted currency on your storefront. This filter must be used on the form object within a currency form.


{% form 'currency' %}
   {{ form | currency_selector: class: 'my_special_class', id: 'Submit'  }}
{% endform %}

URL filters

The following url filters are now deprecated:


Returns the collection image's URL. Accepts an image size as a parameter.


{{ collection.image | collection_img_url: 'medium' }}




Generates the product image URL. Accepts an image size as a parameter.


{{ product.featured_image | product_img_url: "medium" }}



Named size parameters

Instead of using a numeric image size, some older themes use a named size as a parameter for img_url.

Name Maximum image size
pico 16 x 16 pixels
icon 32 x 32 pixels
thumb 50 x 50 pixels
small 100 x 100 pixels
compact 160 x 160 pixels
medium 240 x 240 pixels
large 480 x 480 pixels
grande 600 x 600 pixels
original 1024 x 1024 pixels

Date formats

Date formats are used with certain filters, such as time_tag and date.

The following format parameters are now deprecated:

  • short
  • long


{{ article.published_at | time_tag: format: 'short' }}


<time datetime="2016-02-24T14:47:51Z">February 24, 2016</time>