JSON.ARRTRIM key path start stop
Available in:
Redis Stack / JSON 1.0.0
Time complexity:
O(N) when path is evaluated to a single value where N is the size of the array, O(N) when path is evaluated to multiple values, where N is the size of the key

Trims an array so that it contains only the specified inclusive range of elements.

This command is extremely forgiving and using it with out-of-range indexes will not produce an error. There are a few differences between how RedisJSON v2.0 and legacy versions handle out-of-range indexes.

Behavior as of RedisJSON v2.0:

  • If start is larger than the array's size or start > stop, returns 0 and an empty array.
  • If start is < 0, then start from the end of the array.
  • If stop is larger than the end of the array, it will be treated like the last element.


Array reply of Integer reply - for each path, the array's new size, or Null reply if the matching JSON value is not an array.


redis> JSON.SET doc $ '{"a":[], "nested": {"a": [1,4]}}'
redis> JSON.ARRTRIM doc $..a 1 1
1) (integer) 0
2) (integer) 1
redis> JSON.GET doc $
redis> JSON.SET doc $ '{"a":[1,2,3,2], "nested": {"a": false}}'
redis> JSON.ARRTRIM doc $..a 1 1
1) (integer) 1
2) (nil)
redis> JSON.GET doc $


If you've found issues on this page, or have suggestions for improvement, please submit a request to merge or open an issue in the repository.