feat: support project level custom fields by Zaimwa9 · Pull Request #6736 · Flagsmith/flagsmith

Zaimwa9 · 2026-02-19T15:02:07Z

Thanks for submitting a PR! Please check the boxes below:

I have read the Contributing Guide.
I have added information to docs/ if required so people know about the feature.
I have filled in the "Changes" section below.
I have filled in the "How did you test this code" section below.

Changes

Closes #6620

Support project scoped custom fields which could only be defined at organisation levels

Added project as foreign key to MetadataField
Replaced unique_together with conditional UniqueConstraints
_validate_required_metadata accepts project param
is_required_for fetched and included in responses directly (replacing 2 different requests made in the frontend => coming in next branch)
Added pagination

New endpoint

GET /projects/{id}/metadata/fields/ with
- ?include_organisation to include inherited org-level fields (calculates the precedence for project in case of conflicts)
- ?entity=feature|segment|environment to only return fields of the given identity (simplifies the creation of the identity)

⚠️
In case of conflicting name, project custom fields takes precedence and org ones are skipped

How did you test this code?

Tests and following PR

…th/flagsmith into feat/support-project-level-custom-fields

…endpoint

…th/flagsmith into feat/support-project-level-custom-fields

vercel · 2026-02-19T15:02:12Z

The latest updates on your projects. Learn more about Vercel for GitHub.

3 Skipped Deployments

Project	Deployment	Actions	Updated (UTC)
docs	Ignored	Preview	Feb 19, 2026 4:25pm
flagsmith-frontend-preview	Ignored	Preview	Feb 19, 2026 4:25pm
flagsmith-frontend-staging	Ignored	Preview	Feb 19, 2026 4:25pm

github-actions · 2026-02-19T15:05:00Z

Docker builds report

Image	Build Status	Security report
`ghcr.io/flagsmith/flagsmith-e2e:pr-6736`	Finished ✅	Skipped
`ghcr.io/flagsmith/flagsmith-api-test:pr-6736`	Finished ✅	Skipped
`ghcr.io/flagsmith/flagsmith-frontend:pr-6736`	Finished ✅	Results ✅
`ghcr.io/flagsmith/flagsmith:pr-6736`	Finished ✅	Results ✅
`ghcr.io/flagsmith/flagsmith-private-cloud:pr-6736`	Finished ✅	Results ✅
`ghcr.io/flagsmith/flagsmith-api:pr-6736`	Finished ✅	Results ✅

codecov · 2026-02-19T15:21:09Z

Codecov Report

✅ All modified and coverable lines are covered by tests.
⚠️ Please upload report for BASE (fix/required-metadata-validation@3cc20aa). Learn more about missing BASE report.

Additional details and impacted files

@@                         Coverage Diff                         @@
##             fix/required-metadata-validation    #6736   +/-   ##
===================================================================
  Coverage                                    ?   98.24%           
===================================================================
  Files                                       ?     1313           
  Lines                                       ?    48782           
  Branches                                    ?        0           
===================================================================
  Hits                                        ?    47928           
  Misses                                      ?      854           
  Partials                                    ?        0

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

for more information, see https://pre-commit.ci

…:Flagsmith/flagsmith into feat/support-project-level-custom-fields

Zaimwa9 · 2026-02-19T16:22:27Z

api/metadata/migrations/0002_add_project_to_metadata_field.py

+        migrations.AddConstraint(
+            model_name="metadatafield",
+            constraint=models.UniqueConstraint(
+                condition=models.Q(("project__isnull", True)),
+                fields=("name", "organisation"),
+                name="unique_org_level_metadata_field",
+            ),
+        ),
+        migrations.AddConstraint(
+            model_name="metadatafield",
+            constraint=models.UniqueConstraint(
+                condition=models.Q(("project__isnull", False)),
+                fields=("name", "organisation", "project"),
+                name="unique_project_level_metadata_field",
+            ),
+        ),


I'm not sure this is compatible with Oracle. Is it a requirement ?

IIRC, we're not supporting Oracle moving forwards in code. I'd defer confirmation to @matthewelwell.

We are a while away from dropping oracle support so we'll need to consider it still.

So my findings are that Oracle silently skips UniqueConstraint and the constraint is not enforced at the database level.
It seems that it's already a pattern that we've used in previous migrations e.g:

FeatureState

Release pipeline feature versioning

And older in LD importer

So the support is not optimal for Oracle but still compatible, if ever you have some thoughts on this @gagantrivedi ?

gagantrivedi · 2026-02-23T05:02:28Z

⚠️
In case of conflicting name, project custom fields takes precedence and org ones are skipped

Wouldn't it be less confusing to not allow conflicts?

Zaimwa9 · 2026-02-23T08:22:16Z

@gagantrivedi

Wouldn't it be less confusing to not allow conflicts?

I do remember asking the question while grooming and we agreed on allowing re-creating the custom fields at project level.
Maybe @asaphko you can give us some product-wise insights here. To summarize, in project settings, we show as read-only the organisation field. You can create the same field for your project and this one will take over. A use-case I can see is to have a global custom field that you can require or not at project level.

What Gagan suggests is to simply forbid and return an error if the name already exists in the organisation (be it project/org level)

Zaimwa9 added 9 commits February 16, 2026 18:29

feat: added-project-support-for-custom-fields

79771ed

feat: reworked-comments

2c39ce8

feat: project-custom-fields-override-org-ones

7057609

Merge branch 'fix/required-metadata-validation' of github.com:Flagsmi…

e2dc65a

…th/flagsmith into feat/support-project-level-custom-fields

Merge branch 'fix/required-metadata-validation' of github.com:Flagsmi…

aad191d

…th/flagsmith into feat/support-project-level-custom-fields

feat: reviewed-query-params-and-filtering

cd7b03c

feat: fetch-metadata-model-in-api-and-separate-custom-fields-project-…

4fea476

…endpoint

feat: added-pagination-and-filtering-by-entity-to-custom-fields

790ff64

Merge branch 'fix/required-metadata-validation' of github.com:Flagsmi…

6d3bb18

…th/flagsmith into feat/support-project-level-custom-fields

Zaimwa9 requested a review from a team as a code owner February 19, 2026 15:02

Zaimwa9 requested review from emyller and removed request for a team February 19, 2026 15:02

Zaimwa9 requested review from a team and gagantrivedi and removed request for emyller February 19, 2026 15:02

github-actions bot added the api Issue related to the REST API label Feb 19, 2026

Zaimwa9 changed the title ~~Feat/support project level custom fields~~ feat: support project level custom fields Feb 19, 2026

Zaimwa9 and others added 3 commits February 19, 2026 16:26

feat: fixed-edit-delete-project-permissions-for-custom-fields

ce1522a

feat: refactored-validated-required-metadata

733ece1

[pre-commit.ci] auto fixes from pre-commit.com hooks

0161047

for more information, see https://pre-commit.ci

github-actions bot added the feature New feature or request label Feb 19, 2026

Zaimwa9 added 2 commits February 19, 2026 16:49

feat: removed-unused-variable

986df6a

Merge branch 'feat/support-project-level-custom-fields' of github.com…

936dee9

…:Flagsmith/flagsmith into feat/support-project-level-custom-fields

github-actions bot added feature New feature or request and removed feature New feature or request labels Feb 19, 2026

Zaimwa9 commented Feb 19, 2026

View reviewed changes

feat: added-pagination-to-org-metadata-fields

40c5620

github-actions bot added feature New feature or request and removed feature New feature or request labels Feb 19, 2026

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Comments

feat: support project level custom fields#6736

feat: support project level custom fields#6736
Zaimwa9 wants to merge 15 commits intofix/required-metadata-validationfrom
feat/support-project-level-custom-fields

Zaimwa9 commented Feb 19, 2026

Uh oh!

vercel bot commented Feb 19, 2026 •

edited

Loading

Uh oh!

github-actions bot commented Feb 19, 2026 •

edited

Loading

Uh oh!

codecov bot commented Feb 19, 2026 •

edited

Loading

Uh oh!

Zaimwa9 Feb 19, 2026

Uh oh!

emyller Feb 20, 2026

Uh oh!

matthewelwell Feb 23, 2026

Uh oh!

Zaimwa9 Feb 23, 2026 •

edited

Loading

Uh oh!

gagantrivedi commented Feb 23, 2026

Uh oh!

Zaimwa9 commented Feb 23, 2026 •

edited

Loading

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

Comments

Conversation

Zaimwa9 commented Feb 19, 2026

Changes

How did you test this code?

Uh oh!

vercel bot commented Feb 19, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions bot commented Feb 19, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Docker builds report

Uh oh!

codecov bot commented Feb 19, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Codecov Report

Uh oh!

Zaimwa9 Feb 19, 2026

Choose a reason for hiding this comment

Uh oh!

emyller Feb 20, 2026

Choose a reason for hiding this comment

Uh oh!

matthewelwell Feb 23, 2026

Choose a reason for hiding this comment

Uh oh!

Zaimwa9 Feb 23, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

gagantrivedi commented Feb 23, 2026

Uh oh!

Zaimwa9 commented Feb 23, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

vercel bot commented Feb 19, 2026 •

edited

Loading

github-actions bot commented Feb 19, 2026 •

edited

Loading

codecov bot commented Feb 19, 2026 •

edited

Loading

Zaimwa9 Feb 23, 2026 •

edited

Loading

Zaimwa9 commented Feb 23, 2026 •

edited

Loading