---
title: "Liquid tags: decrement"
description: |-
  Creates a new variable, with a default value of -1, that's decreased by 1 with each subsequent call.

  > Caution:
  > Predefined Liquid objects can be overridden by variables with the same name.
  > To make sure that you can access all Liquid objects, make sure that your variable name doesn't match a predefined object's name.
api_name: liquid
source_url:
  html: https://shopify.dev/docs/api/liquid/tags/decrement
  md: https://shopify.dev/docs/api/liquid/tags/decrement.md
---

# decrement

Creates a new variable, with a default value of -1, that's decreased by 1 with each subsequent call.

***

Caution

Predefined Liquid objects can be overridden by variables with the same name. To make sure that you can access all Liquid objects, make sure that your variable name doesn't match a predefined object's name.

***

Variables that are declared with `decrement` are unique to the [layout](https://shopify.dev/themes/architecture/layouts), [template](https://shopify.dev/themes/architecture/templates), or [section](https://shopify.dev/themes/architecture/sections) file that they're created in. However, the variable is shared across [snippets](https://shopify.dev/themes/architecture/snippets) included in the file.

Similarly, variables that are created with `decrement` are independent from those created with [`assign`](https://shopify.dev/docs/api/liquid/tags/assign) and [`capture`](https://shopify.dev/docs/api/liquid/tags/capture). However, `decrement` and [`increment`](https://shopify.dev/docs/api/liquid/tags/increment) share variables.

## Syntax

```oobleckTag
{% decrement variable_name %}
```

variable\_name

The name of the variable being decremented.

```liquid
{% decrement variable %}
{% decrement variable %}
{% decrement variable %}
```

##### Code

```
{% decrement variable %}
{% decrement variable %}
{% decrement variable %}
```

## Output

```html
-1
-2
-3
```