Возвращает разницу уровней между текущей и предыдущей категорией, по сути число означает сколько закрывающих тегов надо вывести при отображении дерева.
Вывод дерева категорий (с использованием объекта collections.flatten - полный список категорий магазина, всех уровней вложенности):
{% for collection in collections.flatten %}
{% if collection.first? %}<ul>{% endif %}
{% if collection.show? %}
<li {% if collection.current? %}class="active"{% endif %}>
<a href="{{ collection.url }}">{{ collection.title }}</a>
</li>
{% endif %}
{% if collection.last? %} {% for i in (1..collection.level_difference) %}</ul>{% endfor %} {% endif %}
{% endfor %}