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

ActiveLibrary

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.1(4mo ago)1172—6.2%GPL-3.0-or-laterPHPPHP >=8.1.0

Since Dec 6Pushed 4mo 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 1mo ago

READMEChangelog (2)Dependencies (5)Versions (4)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.

### 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.0 or higher
- Advanced Custom Fields (ACF) Pro or Free version
- Composer (for development installation)

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

[](#installation)

### Via WordPress Admin

[](#via-wordpress-admin)

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

### Via Composer

[](#via-composer)

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

**Note:** When installing via Composer, you need to configure the plugin directory URL. Add this filter to your theme's `functions.php`:

```
add_filter( 'codesoup_acf_admin_categories_plugin_dir_url', function( $base_url ) {
	return sprintf(
		'%s/vendor/codesoup/acf-admin-categories',
		get_stylesheet_directory_uri()
	);
});
```

### Manual Installation

[](#manual-installation)

1. Download the plugin files
2. Upload the `codesoup-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 Field Groups

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

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

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

[](#screenshots)

1. **Field Group Categories Management** - Create and manage your field group categories
2. **Category Assignment Interface** - Assign categories directly from field group settings
3. **Filtered Field Groups List** - Filter and view field groups by category
4. **Category Column** - See assigned categories at a glance

Changelog
---------

[](#changelog)

### 1.0.0

[](#100)

- Initial release
- Custom taxonomy for field group categories
- Category assignment interface in ACF field groups
- Category filtering and column display

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

40

—

FairBetter than 87% of packages

Maintenance80

Actively maintained with recent releases

Popularity16

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity45

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 71.4% 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 ~17 days

Total

2

Last Release

136d ago

### Community

Maintainers

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

---

Top Contributors

[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (20 commits)")[![Bobz-zg](https://avatars.githubusercontent.com/u/420604?v=4)](https://github.com/Bobz-zg "Bobz-zg (8 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

[redux-framework/redux-framework

Build better and beautiful sites in WordPress, faster.

1.8k6.2k](/packages/redux-framework-redux-framework)[vinkla/extended-acf

Register advanced custom fields with object-oriented PHP

503264.8k11](/packages/vinkla-extended-acf)[samrap/acf-fluent

A fluent interface for the Advanced Custom Fields WordPress plugin

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

ACF Codifier

133215.1k19](/packages/devgeniem-acf-codifier)[php-stubs/acf-pro-stubs

Advanced Custom Fields PRO stubs for static analysis.

73692.8k47](/packages/php-stubs-acf-pro-stubs)[log1x/acf-editor-palette

A replica Gutenberg color picker field for Advanced Custom Fields.

100284.1k](/packages/log1x-acf-editor-palette)

PHPackages © 2026

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