https://github.com/christophecvb/strapi-plugin-generic-custom-fields
This plugin allows you to easily add custom fields to Strapi
https://github.com/christophecvb/strapi-plugin-generic-custom-fields
plugin strapi strapi-plugin
Last synced: 5 months ago
JSON representation
This plugin allows you to easily add custom fields to Strapi
- Host: GitHub
- URL: https://github.com/christophecvb/strapi-plugin-generic-custom-fields
- Owner: ChristopheCVB
- License: mit
- Created: 2025-06-06T12:55:27.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2026-01-30T16:15:46.000Z (5 months ago)
- Last Synced: 2026-01-31T06:05:03.466Z (5 months ago)
- Topics: plugin, strapi, strapi-plugin
- Language: TypeScript
- Homepage:
- Size: 3.32 MB
- Stars: 10
- Watchers: 0
- Forks: 2
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.md
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
Strapi v5 - Plugin Generic Custom Fields
Powerful Strapi Plugin to easily create Custom Fields
---
A plugin for [Strapi Headless CMS](https://github.com/strapi/strapi) that provides a powerful and easy way to add custom fields to your Strapi entities.
## Features
- Add custom fields to entities with a simple configuration.
### What can it be used for?
- Create an Enum field with labels
- Fetch items from an API (with or without authentication)
- Fetch items from a local source (json file, database, etc.)
## Roadmap
- Support pagination for fetching items
- Support for different field types (text, number, date, etc.)
- Validation rules for custom fields
- Any idea? [Open an issue](https://github.com/ChristopheCVB/strapi-plugin-generic-custom-fields/issues)
## Usage
To configure the Generic Custom Fields plugin, add your custom fields configuration to the plugin settings. Each custom field should follow this structure:
```typescript
type Config = {
customFields: Array<{
name: string; // The unique name of the custom field.
description?: string; // A description for the custom field.
icon?: string; // One of the supported StrapiIcon names, e.g. 'Alien', 'Archive', 'ArrowDown', etc.
inputSize?: {
default: 4 | 6 | 8 | 12; // Default input size.
isResizable: boolean; // Whether the input size can be changed.
};
searchable?: boolean; // Whether the custom field is searchable (calls fetchItems with query).
fetchItems: ({ query: string | undefined }): { items: Item[] } | Promise<{ items: Item[] }>; // Function to fetch multiple items. This function is called on server-side.
fetchItem: ({ value: string }): Item | Promise; // Function to fetch a single item. This function is called on server-side.
}>,
}
type Item = {
value: string; // Unique identifier for the item. This is used to store the value of the custom field.
label: string; // Label of the item.
icon?: {
src: string; // URL of the icon.
colorMask?: boolean; // Whether the icon should be masked with the color of the field.
}
};
```
This configuration allows you to define custom fields that can fetch items either synchronously or asynchronously. The `fetchItems` function is used to retrieve a list of items based on a query string that can be empty, while the `fetchItem` function retrieves a single item based on its value.
### Example Configuration
Check Wiki page for [Example Implementations](https://github.com/ChristopheCVB/strapi-plugin-generic-custom-fields/wiki/Example-implementations)