Taxonomy Terms Order - a Statamic Addon

Drag & drop reordering for taxonomy terms in the Statamic Control Panel.

Statamic supports reordering entries in collections, but taxonomy terms are always sorted alphabetically. This addon adds a dedicated Terms Order page per taxonomy where you can drag terms into the desired order. After saving, the Control Panel terms listing follows that order automatically — and your frontend templates can too.

Features

Drag & drop reordering of taxonomy terms, straight from the CP navigation
Order is stored as a plain order field in each term's YAML — no database, no magic
Sets sort_by: order on the taxonomy, so the native CP terms listing follows the manual order automatically
New terms are appended to the end of the list automatically
Reset button to remove the manual order and go back to alphabetical sorting
Dedicated reorder {taxonomy} terms permission per taxonomy
Multisite-ready: order is shared across sites, titles stay localized
Zero core overrides: built entirely on Statamic's public addon APIs

How to Install

Run the following command from your project root:

composer require keyagency/taxonomy-terms-order

How to Use

Open the Control Panel. A Terms Order item appears in the Tools section of the navigation. It links to an overview of all orderable taxonomies (there's also a child link per taxonomy).
Pick a taxonomy, drag the terms into the desired order and hit Save Order (or cmd+s).
Done. The terms listing and your frontend now follow the manual order.

Changed your mind? Hit Reset on the taxonomy's order page to remove the manual order from all terms and go back to alphabetical sorting.

Limiting which taxonomies are orderable

By default every taxonomy can be reordered. To limit this, publish the config:

php artisan vendor:publish --tag=taxonomy-terms-order-config

// config/statamic/taxonomy-terms-order.php
 
return [
    'taxonomies' => ['article_categories'], // or ['*'] for all
];

Permissions

Non-super users need the Reorder terms permission, which appears per taxonomy in the "Taxonomy Terms Order" permissions group. Users without this permission won't see the navigation item.

Frontend

The {{ taxonomy:* }} tag does not apply a default sort, so add the order_by parameter in your templates:

{{ taxonomy:article_categories order_by="order:asc|title:asc" }}
    {{ title }}
{{ /taxonomy:article_categories }}

The title:asc fallback keeps taxonomies without a manual order sorted alphabetically, so the same partial works for both.

How it works

Saving an order writes a sequential order key into each term's YAML file (content/taxonomies/<taxonomy>/<slug>.yaml).
The taxonomy config gets sort_by: order and sort_dir: asc, which Statamic natively supports for sorting the CP terms listing.
A TermSaving listener assigns max(order) + 1 to terms created without an order, so they land at the bottom of the list.

Support

Found a bug or have a feature request? Open an issue or email [email protected].

About Key Agency

Key Agency is a digital agency based in Amsterdam that helps brands grow with strategy, content, technology and advertising working together as one digital ecosystem.

Website: keyagency.nl
Contact: [email protected]