Dynamic Enumeration
Add a new type of enumeration that works like a combobox, where you can get data already registered in the enumeration previously, or add a new item to select list.
Latest version
released September 26, 2025
npm install strapi-plugin-dynamic-enumeration-field
Dynamic Enumeration
Introduction | Features | Installation | Configuration | Api | License
:tada: Introduction
This plugin adds a new type of enumeration that works like a combobox, where you can get data already registered in the enumeration previously, or add a new item to the select options.
:page_facing_up: Features
- New field
Dynamic Enumerationappears in admincontent-type-builderpage, in thecustomtab. - Save only registration options and remove options that is not being used.
- Works inside
ComponentsandDynamic Zones. - Separates each field options by its
APIorComponent - You can create
Globalsfields, which keep the same list between differentAPIandComponents - You can load the options in plugin
APIorService. For list the data in your frontend, for example.
:cd: Installation
Install this plugin by adding it to the dependencies of your Strapi project.
# Yarn
yarn add strapi-plugin-dynamic-enumeration-field
# NPM
npm install strapi-plugin-dynamic-enumeration-field
# PNPM
pnpm install strapi-plugin-dynamic-enumeration-fieldAfter that you must add it to your plugin configuration file.
:wrench: Configuration
Add the code below to your ./config/plugins.js file:
module.exports = ({ env }) => ({
// ...
'dynamic-enumeration': {
enabled: true,
},
// ...
});After that, you'll need to build your admin panel:
npm run buildAdding globals field
You can add several global field keys in the config part of the plugin settings.
module.exports = ({ env }) => ({
// ...
'dynamic-enumeration': {
enabled: true,
config: {
globals: {
// Unique Key Name
'my-global-enumeration': {
// Frontend Name
name: 'My Global Enumeration',
// Fixed default values
defaults: ['Strapi', 'Node.js', 'React.js'],
},
// ...Others globals fields
},
},
},
// ...
});:book: Api
The plugin adds two Api and Service to your application:
Get Enumeration Values
You can get the options added to a field, sending the uid of the API or Component, and the name of the field.
The uid It is in the format api::<api>.<api> for api, and <component-folder>.<component-file-name> for components
See the example below:
EXAMPLE
const uid = "api::my-api.my-api"
const name = "city"
const locale = 'en' // Optional, if you use i18b
// Using Fetch
await fetch(`${API_URL}/api/dynamic-enumeration?uid=${uid}&name=${name}&locale=${locale}`);
// GET /api/dynamic-enumeration?uid=your-api&name=your-attribute-name&locale=locale
// Using Service in Strapi
const SERVICE_UID = 'plugin::dynamic-enumeration.dynamic-enumeration-service'
const service = strapi.service(SERVICE_UID)
const data = await service.getValues({
uid,
name,
locale // Optional
})
Get Globals Values
You can get the options added to all global field, sending the key of the Globals Field configured in your plugins file. ( See the settings part above )
See the example below:
EXAMPLE
// In Your "./config/plugins.js" file
module.exports = ({ env }) => ({
// ...
'dynamic-enumeration': {
enabled: true,
config: {
globals: {
// The Global Key
'my-field': {
// Configurations
},
},
},
},
// ...
});
// Using Fetch
await fetch(`${API_URL}/api/dynamic-enumeration/globals?key=my-field`);
// GET /api/dynamic-enumeration/globals?key=global-key&locale=locale
// Using Service in Strapi
const SERVICE_UID = 'plugin::dynamic-enumeration.dynamic-enumeration-service'
const service = strapi.service(SERVICE_UID)
const data = await service.getGlobalValues({
key: 'my-field',
locale // Optional
})
:memo: License
This project is under the MIT license. See the LICENSE file for more details.
