PHPackages justinholtweb/craft-tidytags - 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. justinholtweb/craft-tidytags ActiveCraft-plugin[Utility & Helpers](/categories/utility) justinholtweb/craft-tidytags ============================ Tag manager for Craft CMS 5 with multi-site support and duplicate detection. 5.1.0(3w ago)00proprietaryPHPPHP >=8.2 Since Apr 10Pushed 3w agoCompare [ Source](https://github.com/justinholtweb/craft-tidytags)[ Packagist](https://packagist.org/packages/justinholtweb/craft-tidytags)[ RSS](/packages/justinholtweb-craft-tidytags/feed)WikiDiscussions main Synced 1w ago READMEChangelog (3)Dependencies (1)Versions (4)Used By (0) Tidy Tags ========= [](#tidy-tags) A tag manager for Craft CMS 5 with multi-site support, cross-source duplicate detection, and optional read-only support for entry-backed tags. Tidy Tags gives you a control panel section for auditing, cleaning, and merging tags across every site in your Craft install. It compares tags against each other *and* against tag-like entry sections (Teams, Competitions, Topics — anything you've entrified or that should stay aligned), shows usages inline, and watches tag fields while editors are working so they're nudged toward existing taxonomy before they create yet another `England` tag. If you've [entrified](https://craftcms.com/blog/entrification) your tags with `php craft entrify/tags`, you can point Tidy Tags at the resulting channel sections and they'll show up on the dashboard, in the duplicate scanner, and in the editor "did you mean?" warning alongside native tag groups. Entry-backed sources stay read-only for destructive actions but support relation swap — see [Tag-like entry sections](#tag-like-entry-sections) below. Requirements ------------ [](#requirements) - Craft CMS 5.0.0 or later - PHP 8.2 or later Installation ------------ [](#installation) Until this plugin is published to the Craft Plugin Store, install it as a path repository. 1. Clone or place this repo next to your Craft project, e.g. `../craft-tidytags`. 2. In your project's `composer.json`, add the path repository: ``` { "repositories": [ { "type": "path", "url": "../craft-tidytags" } ], "require": { "justinholtweb/craft-tidytags": "@dev" } } ``` 3. Install the package: ``` composer require justinholtweb/craft-tidytags ``` 4. In the Craft control panel, go to **Settings → Plugins** and install **Tidy Tags**. Features -------- [](#features) ### Dashboard [](#dashboard) Navigate to **Tidy Tags** in the CP sidebar. The dashboard lists every source in the install with: - The source name, handle, and a **Tags** or **Entries** badge - Total count (unique elements across all sites) - Per-site counts Click **Manage** on a row to open that source's list. "Sources" includes every native tag group plus any channel sections you've designated as tag-like. ### Group view [](#group-view) The group view shows every tag in a group with per-site columns so you can see where a tag is translated and where it isn't. From here you can: - **Filter** by site or search by title - **Rename** a single tag (all sites or one site) - **Merge** two or more tags — relations are re-pointed to the target tag, duplicates are de-duped, and source tags are deleted in a single transaction - **Delete** one or more tags in bulk All actions are multi-site aware. Choosing "All sites" in the filter shows every tag once (keyed to the primary site) with its translations in sibling columns; choosing a specific site scopes everything to that site. ### Duplicate scanner [](#duplicate-scanner) The **Duplicates** tab has two scopes: - **Within source** — clusters near-duplicates inside a single tag group or section. For tag-group clusters you can pick a target and merge in one click. Entry-backed clusters offer **Swap relations** instead, which re-points relations from the duplicate entries onto the chosen target without deleting anything. - **Across sources** — pools every source together and surfaces clusters that span more than one source. Useful when an editor has created a Tag for something already maintained as a Team or Competition. Always uses **Swap relations**, never auto-deletes. Each cluster item: - Links to its tag/entry edit screen - Shows the source it came from with a **Tag** or **Entry** badge - Shows configured display field values (e.g. `sport: Football`) so you can tell same-named items apart - Has a **Show usages** button that lists every entry holding a relation to it, with edit links The Levenshtein threshold is configurable per-scan (default 2, range 1–6). #### Differentiator and display fields [](#differentiator-and-display-fields) Under **Settings → Plugins → Tidy Tags** you can pick, per source: - **Differentiator field** — when set, two items with the same normalized title but different differentiator values are *not* clustered as duplicates. This is how `England (Football)` and `England (Cricket)` stay distinct from each other while a stray `England` tag still gets flagged against both. - **Display fields** — values appear next to each item in clusters and the editor warning, so reviewers can disambiguate at a glance. When one item has a differentiator value and the other doesn't (e.g. a Tag with no field vs. a Team with `sport: Football`), the cluster is still shown — Tidy Tags treats "missing" as "unknown, surface for review" rather than "definitely different". ### "Did you mean?" warnings for editors [](#did-you-mean-warnings-for-editors) Tidy Tags ships a small JS asset bundle that loads on every control panel page. When an editor starts typing a new tag into a tag field, the plugin debounces the input, asks the `tidytags/tags/check-duplicate` action for similar items, and shows a non-blocking amber notice below the field listing matches across: - The tag group the field is bound to - Every configured tag-like entry section Each match shows the differentiator value (if configured) and links directly to the existing item, so an editor about to create `England` in a tag field is told that `England (Football)` already exists as a Team and given a one-click way to open it. The warning is informational — it never blocks the editor — but it nudges people toward reusing existing taxonomy instead of duplicating. ### Tag-like entry sections [](#tag-like-entry-sections) Craft's `php craft entrify/tags` command converts a tag group into a channel section, turning each tag into an entry. Once entrified, your "tags" are regular entries with URLs, bodies, drafts, authors, and revisions. Tidy Tags can surface these sections alongside native tag groups so the dashboard and scanners aren't suddenly empty after entrification. To opt a section in: 1. Go to **Settings → Plugins → Tidy Tags**. 2. Check each channel section you want surfaced under **Tag-like sections**. 3. Save. **Entry-backed sources are read-only for destructive actions.** Rename, merge, and delete are tag-only because entries carry URLs, bodies, drafts, and authorship that can't be safely mutated through a tag-sized interface — and Craft already has better UIs for editing entries. You still get: - Dashboard counts (total + per-site) - Per-site title browsing and search - Within-source and cross-source duplicate clusters - **Swap relations** — the safe primitive that re-points relations from one entry to another without touching the entries themselves - Inclusion in the editor "did you mean?" warning when the editor is in a tag field ### Configuration file [](#configuration-file) The plugin settings screen is the primary place to manage tag-like sections and per-source field config. Every field on the settings model can also be driven from `config/tidytags.php`, which is overlaid on top of the saved settings at request time — handy for per-environment configuration: ```