PHPackages                             codesoup/acf-admin-categories - 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. codesoup/acf-admin-categories

ActiveLibrary[Utility & Helpers](/categories/utility)

codesoup/acf-admin-categories
=============================

A WordPress plugin that adds category organization to Advanced Custom Fields (ACF) field groups for better management and organization.

v1.0.3(2mo ago)1311—8.3%GPL-3.0-or-laterPHPPHP >=8.1.0

Since Apr 20Pushed 2mo agoCompare

[ Source](https://github.com/code-soup/acf-admin-categories)[ Packagist](https://packagist.org/packages/codesoup/acf-admin-categories)[ Docs](https://github.com/code-soup/acf-admin-categories)[ RSS](/packages/codesoup-acf-admin-categories/feed)WikiDiscussions master Synced 2w ago

READMEChangelog (3)Dependencies (10)Versions (5)Used By (0)

CodeSoup ACF Admin Categories
=============================

[](#codesoup-acf-admin-categories)

CodeSoup ACF Admin Categories extends the Advanced Custom Fields plugin by adding a custom taxonomy system that allows you to categorize and organize your field groups. This makes it easier to manage large numbers of field groups by providing filtering, sorting, and visual organization tools.

[![Filter and view field groups by category](assets/screenshot-01.png)](assets/screenshot-01.png)

### Use Cases

[](#use-cases)

- **Large Projects**: Organize field groups by project sections (Header, Footer, Content, etc.)
- **Development Workflow**: Separate field groups by development status (Active, Testing, Deprecated)

Requirements
------------

[](#requirements)

- WordPress 6.0 or higher
- PHP 8.1 or higher
- Advanced Custom Fields (ACF) Pro or Free version

Installation
------------

[](#installation)

### Via WordPress Admin (Recommended)

[](#via-wordpress-admin-recommended)

1. Download the plugin ZIP file from the [releases page](https://github.com/code-soup/acf-admin-categories/releases)
2. Navigate to **Plugins > Add New > Upload Plugin**
3. Choose the downloaded ZIP file and click **Install Now**
4. Activate the plugin through the **Plugins** menu

No additional configuration required. The plugin includes a built-in autoloader and works out of the box.

### Via Composer (Theme Integration)

[](#via-composer-theme-integration)

```
composer require codesoup/acf-admin-categories
```

Load the plugin from your theme's `functions.php`:

```
// Load ACF Admin Categories plugin
$acf_categories = get_template_directory() . '/vendor/codesoup/acf-admin-categories/index.php';
if ( file_exists( $acf_categories ) ) {
    require_once $acf_categories;

    // Configure plugin assets URL for Composer installation
    add_filter( 'codesoup_acf_admin_categories_plugin_dir_url', function( $base_url ) {
        return get_stylesheet_directory_uri() . '/vendor/codesoup/acf-admin-categories';
    });
}
```

**Note:** The plugin automatically uses your theme's Composer autoloader when available, or falls back to its own PSR-4 autoloader.

### Manual Installation

[](#manual-installation)

1. Download the plugin files
2. Upload the `acf-admin-categories` folder to your `/wp-content/plugins/` directory
3. Activate the plugin through the **Plugins** menu in WordPress

Usage
-----

[](#usage)

### Creating Field Categories

[](#creating-field-categories)

1. Navigate to **Custom Fields > Field Categories** in your WordPress admin
2. Click **Add New Category**
3. Enter a name and optional description for your category
4. Click **Add New Category** to save

### Assigning Categories to Field Groups

[](#assigning-categories-to-field-groups)

1. Edit any ACF Field Group
2. Click the **Field Category** tab in the field group settings
3. Check the categories you want to assign to this field group
4. Save the field group

### Filtering and Sorting Field Groups

[](#filtering-and-sorting-field-groups)

1. Go to **Custom Fields > Field Groups**
2. Use the category dropdown filter above the list to filter by specific categories
3. Click on any category name in the **Category** column to filter by that category
4. Click the **Category** column header to sort field groups alphabetically by category name

### Managing Categories

[](#managing-categories)

- **Edit Categories**: Go to **Custom Fields > Field Categories** to edit existing categories
- **Hierarchical Structure**: Create parent/child relationships between categories
- **Bulk Management**: Use WordPress's built-in bulk actions for category management

Features
--------

[](#features)

- **Categorize Field Groups**: Organize ACF field groups with custom categories
- **Composer Ready**: Install via Composer or WordPress plugin directory

Screenshots
-----------

[](#screenshots)

1. **Filter and Sort Field Groups** - Filter field groups by category using dropdown, click category names to filter, and sort alphabetically by clicking column header [![Filter and view field groups by category](assets/screenshot-01.png)](assets/screenshot-01.png)
2. **Category Assignment** - Assign categories directly from field group settings using the Field Category tab [![Assign categories from field group settings](assets/screenshot-02.png)](assets/screenshot-02.png)
3. **Category Management** - Create and manage your field group categories with hierarchical support [![Create and manage your field group categories](assets/screenshot-03.png)](assets/screenshot-03.png)

Changelog
---------

[](#changelog)

See [CHANGELOG.md](CHANGELOG.md) for detailed version history.

Support
-------

[](#support)

Please use [GitHub Issues](https://github.com/code-soup/acf-admin-categories/issues) to submit any bugs or feature requests.

License
-------

[](#license)

This project is licensed under the GPL v3 or later - see the [LICENSE.txt](LICENSE.txt) file for details.

###  Health Score

42

—

FairBetter than 89% of packages

Maintenance87

Actively maintained with recent releases

Popularity17

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity45

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 88.9% 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 ~67 days

Total

3

Last Release

64d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/00b8448f7b4a45eae365d2016244dddf72ab4f8556747fa41521f23863b09a65?d=identicon)[bobz-zg](/maintainers/bobz-zg)

---

Top Contributors

[![Bobz-zg](https://avatars.githubusercontent.com/u/420604?v=4)](https://github.com/Bobz-zg "Bobz-zg (8 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (1 commits)")

---

Tags

wordpressSettingsoptionscustom-post-typeacfcomposer-packageacf-pro

### Embed Badge

![Health badge](/badges/codesoup-acf-admin-categories/health.svg)

```
[![Health](https://phpackages.com/badges/codesoup-acf-admin-categories/health.svg)](https://phpackages.com/packages/codesoup-acf-admin-categories)
```

###  Alternatives

[vinkla/extended-acf

Register advanced custom fields with object-oriented PHP

507284.4k14](/packages/vinkla-extended-acf)[samrap/acf-fluent

A fluent interface for the Advanced Custom Fields WordPress plugin

28457.1k4](/packages/samrap-acf-fluent)[devgeniem/acf-codifier

ACF Codifier

133222.8k29](/packages/devgeniem-acf-codifier)[log1x/acf-editor-palette

A replica Gutenberg color picker field for Advanced Custom Fields.

101299.6k](/packages/log1x-acf-editor-palette)[hellonico/acf-country

A country field for ACF.

12195.6k](/packages/hellonico-acf-country)[log1x/acf-phone-number

A real ACF phone number field.

11975.2k](/packages/log1x-acf-phone-number)

PHPackages © 2026

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