PHPackages                             keyagency/taxonomy-terms-order - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. keyagency/taxonomy-terms-order

ActiveStatamic-addon[Utility & Helpers](/categories/utility)

keyagency/taxonomy-terms-order
==============================

Drag & drop reordering for Statamic taxonomy terms

v1.0.1(1mo ago)0129MITPHPPHP ^8.2CI passing

Since Jul 8Pushed 1mo agoCompare

[ Source](https://github.com/keyagency/taxonomy-terms-order)[ Packagist](https://packagist.org/packages/keyagency/taxonomy-terms-order)[ Docs](https://keyagency.nl)[ RSS](/packages/keyagency-taxonomy-terms-order/feed)WikiDiscussions main Synced 1w ago

READMEChangelog (2)Dependencies (4)Versions (3)Used By (0)

Taxonomy Terms Order
====================

[](#taxonomy-terms-order)

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
--------

[](#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
--------------

[](#how-to-install)

Requires Statamic 6.21 or higher (the version that introduced default sorting support for taxonomies).

Run the following command from your project root:

```
composer require keyagency/taxonomy-terms-order
```

How to Use
----------

[](#how-to-use)

1. 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).
2. Pick a taxonomy, drag the terms into the desired order and hit **Save Order** (or cmd+s).
3. 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

[](#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

[](#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

[](#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
------------

[](#how-it-works)

- Saving an order writes a sequential `order` key into each term's YAML file (`content/taxonomies//.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
-------

[](#support)

Found a bug or have a feature request? [Open an issue](https://github.com/keyagency/taxonomy-terms-order/issues) or email .

About Key Agency
----------------

[](#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](https://keyagency.nl)
- Contact:

###  Health Score

42

—

FairBetter than 88% of packages

Maintenance90

Actively maintained with recent releases

Popularity14

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity47

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

2

Last Release

48d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/a06cd15447fcfb631b0e29aa3c1a294231260879dfbc3f8e27d8b12f5376d65c?d=identicon)[Key Agency](/maintainers/Key%20Agency)

---

Top Contributors

[![DonnyOexman](https://avatars.githubusercontent.com/u/109585341?v=4)](https://github.com/DonnyOexman "DonnyOexman (4 commits)")

---

Tags

addonlaravelstatamicstatamic-addon

###  Code Quality

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/keyagency-taxonomy-terms-order/health.svg)

```
[![Health](https://phpackages.com/badges/keyagency-taxonomy-terms-order/health.svg)](https://phpackages.com/packages/keyagency-taxonomy-terms-order)
```

###  Alternatives

[statamic/seo-pro

71548.3k](/packages/statamic-seo-pro)[statamic-rad-pack/runway

Eloquently manage your database models in Statamic.

138236.2k8](/packages/statamic-rad-pack-runway)[duncanmcclean/statamic-cargo

Comprehensive e-commerce addon for Statamic. Build bespoke e-commerce sites without the complexity.

3622.8k](/packages/duncanmcclean-statamic-cargo)[thoughtco/statamic-cache-tracker

1941.0k](/packages/thoughtco-statamic-cache-tracker)[statamic-rad-pack/mailchimp

Subscribe registrations or contact forms to Mailchimp

1822.5k](/packages/statamic-rad-pack-mailchimp)[rias/statamic-redirect

29347.4k](/packages/rias-statamic-redirect)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)