[v4] Migration guide: field-level `admin.disable*` → `admin.disabled`

Open
#19,509 0 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

@lazerg is already working on this.

Since Nov 12, 2026.

Assessment

Difficulty
1/5
Estimated time
1-3 hours
Newbie friendliness
1/100
Issue type
Documentation
Clarity
Clearly specified
Activity status
Stale
Tech stack
nextjs, typescript
Domain
documentation

Research direction

Read docs/migration-guide/v4.mdx near the ImageSize.admin section at line 2181, then compare the field-level changes in #16504 with the field docs and migrate-disabled-fields codemod. Add a short adjacent section with the before and after examples for the field-level admin.disabled change. Done when the guide explains the migration for fields as well as ImageSize.admin; an open linked pull request already covers this issue.

Written by the indexing model from the issue text.

Description

Bug created-by: Contributor Payload OSS

Documentation Issue

The v4 migration guide has no section for #16504, which replaced admin.disableListColumn, disableListFilter, disableGroupBy and disableBulkEdit on fields with admin.disabled: boolean | { field?, column?, filter?, groupBy?, bulkEdit? }. The field docs and the migrate-disabled-fields codemod cover it. In the guide, though, it only comes up under ImageSize.admin (L2181), which says "consistent with the shape used by all other fields" without a field-level section to point to.

A short section next to it would help, with the before/after from #16504.

Dominant language
TypeScript
Stars
45.8k
Forks
4.4k
Avg merge
2d 16h
Merged PRs (30d)
251

Getting set up

Open in Codespaces

Starts the project's dev container in your browser, under your own GitHub account.

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from payloadcms/payload

All issues in payloadcms/payload

Similar issues

More TypeScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.