sort_natural

array | sort_natural

Sorts the items in an array in case-insensitive alphabetical order.

Caution

You shouldn't use the sort_natural filter to sort numerical values. When comparing items an array, each item is converted to a string, so sorting on numerical values can lead to unexpected results.

{% assign tags = collection.all_tags | sort_natural %}

{% for tag in tags -%}

{%- endfor %}

Code

{% assign tags = collection.all_tags | sort_natural %}

{% for tag in tags -%}
  {{ tag }}
{%- endfor %}

Data

{
  "collection": {
    "all_tags": [
      "Burning",
      "dried",
      "extra-potent",
      "extracts",
      "fresh",
      "healing",
      "ingredients",
      "music",
      "plant",
      "Salty",
      "supplies"
    ]
  }
}

Output

Burning

dried

extra-potent

extracts

fresh

healing

ingredients

music

plant

Salty

supplies

Output

Burning
dried
extra-potent
extracts
fresh
healing
ingredients
music
plant
Salty
supplies

Anchor to Sort by an array item property

Sort by an array item property

array | sort_natural: string

You can specify an array item property to sort the array items by.

{% assign products = collection.products | sort_natural: 'title' %}

{% for product in products -%}

{%- endfor %}

Code

{% assign products = collection.products | sort_natural: 'title' %}

{% for product in products -%}
  {{ product.title }}
{%- endfor %}

Data

{
  "collection": {
    "products": [
      {
        "title": "Blue Mountain Flower"
      },
      {
        "title": "Charcoal"
      },
      {
        "title": "Crocodile tears"
      },
      {
        "title": "Dandelion milk"
      },
      {
        "title": "Draught of Immortality"
      },
      {
        "title": "Dried chamomile"
      },
      {
        "title": "Forest mushroom"
      },
      {
        "title": "Gift Card"
      },
      {
        "title": "Glacier ice"
      },
      {
        "title": "Ground mandrake root"
      },
      {
        "title": "Health potion"
      },
      {
        "title": "Invisibility potion"
      },
      {
        "title": "Komodo dragon scale"
      },
      {
        "title": "Love Potion"
      },
      {
        "title": "Mana potion"
      },
      {
        "title": "Potion beats"
      },
      {
        "title": "Potion bottle"
      },
      {
        "title": "Viper venom"
      },
      {
        "title": "Whole bloodroot"
      }
    ]
  }
}

Output

Blue Mountain Flower

Charcoal

Crocodile tears

Dandelion milk

Draught of Immortality

Dried chamomile

Forest mushroom

Gift Card

Glacier ice

Ground mandrake root

Health potion

Invisibility potion

Komodo dragon scale

Love Potion

Mana potion

Potion beats

Potion bottle

Viper venom

Whole bloodroot

Output

Blue Mountain Flower
Charcoal
Crocodile tears
Dandelion milk
Draught of Immortality
Dried chamomile
Forest mushroom
Gift Card
Glacier ice
Ground mandrake root
Health potion
Invisibility potion
Komodo dragon scale
Love Potion
Mana potion
Potion beats
Potion bottle
Viper venom
Whole bloodroot

Was this page helpful?