German Jablonski 3c5aa1bdbd docs: improvements and fixes to blocks documentation (#13782) ...

The information about the block field and the blocks themselves wasn't
separated in the documentation, and in fact, there were times when they
were confused and incorrectly mixed.

This caused confusion among our users.

This PR closes an issue, a discussion, and another PR that arose because
it wasn't clear that the `blockName` could be programmatically modified
with the block's content. This is possible through
`admin.components.Label`, which isn't the best name, as it changes the
`label` and the `name` of the block, two different concepts.

I've added a section to the documentation that I think will make all of
this much clearer.

Before:

<img width="266" height="362" alt="image"
src="https://github.com/user-attachments/assets/3b5c95f0-2cdb-4995-a25d-9984f9ab54cb"
/>

After:

<img width="266" height="383" alt="image"
src="https://github.com/user-attachments/assets/99936f64-326f-4d69-a464-626d7f53fa08"
/>


Replaces https://github.com/payloadcms/payload/pull/12135
Fixes https://github.com/payloadcms/payload/issues/12112 & addresses
https://github.com/payloadcms/payload/discussions/4648

---------

Co-authored-by: Said Akhrarov <36972061+akhrarovsaid@users.noreply.github.com>

2025-09-12 15:15:09 +01:00

..

access-control

docs: fix typos, duplicated words, wrong property names etc. (#12480)

2025-05-25 10:58:26 -07:00

admin

feat(ui): adds admin.autoRefresh root config property (#13682)

2025-09-05 17:05:18 -04:00

authentication

docs: missing comma in custom-strategies example (#13701)

2025-09-06 05:25:51 +00:00

configuration

perf(ui): opt-in to the select api in the list view (#13697)

2025-09-08 16:38:00 -04:00

custom-components

fix: server edit view components don't receive document id prop (#13526)

2025-08-21 13:23:51 -04:00

database

fix(db-mongodb): disable join aggregations in DocumentDB compatibility mode (#13270)

2025-08-20 16:31:19 +00:00

email

chore: bump prettier, re-enable prettier for docs (#11695)

2025-03-14 17:13:08 +00:00

examples

chore(examples): remove outdated testing example (#10370)

2025-01-06 00:43:53 +00:00

experimental

feat: adds new experimental.localizeStatus option (#13207)

2025-09-03 10:27:08 +01:00

fields

docs: improvements and fixes to blocks documentation (#13782)

2025-09-12 15:15:09 +01:00

folders

feat: optionally exclude collection documents from appearing in browse-by-folder (#12654)

2025-06-04 13:22:26 -04:00

getting-started

docs: blank-template-url-fix (#13580)

2025-08-25 08:24:50 -07:00

graphql

fix: disable graphql introspection queries when disableIntrospectionInProduction is true (#12982)

2025-07-02 08:33:20 -04:00

hooks

feat: global beforeOperation hook (#13768)

2025-09-10 20:46:49 +00:00

integrations

fix(next): cannot filter trash (#13320)

2025-07-29 14:29:04 -07:00

jobs-queue

docs: remove obsolete scheduler property (#13278)

2025-07-25 16:25:47 -07:00

live-preview

fix(next): cannot filter trash (#13320)

2025-07-29 14:29:04 -07:00

local-api

docs: clarify pagination and improve cross-referencing (#13503)

2025-08-18 16:55:52 +01:00

migration-guide

docs: payload proper nouns (#11792)

2025-03-21 09:04:11 -04:00

performance

fix(ui): significantly more predictable autosave form state (#13460)

2025-08-14 19:36:02 -04:00

plugins

docs(plugin-form-builder): add RadioField documentation (#13529)

2025-09-02 13:38:23 -04:00

production

docs: remove payload cloud (#13240)

2025-07-22 13:12:20 -04:00

queries

docs: adds default populate video (#13586)

2025-08-27 10:58:04 -07:00

query-presets

docs: filterOptions anchor link fix (#12883)

2025-06-22 22:49:12 -04:00

rest-api

feat(live-preview): client-side live preview: simplify population, support hooks and lexical block population (#13619)

2025-09-05 14:40:52 -04:00

rich-text

feat(live-preview): client-side live preview: simplify population, support hooks and lexical block population (#13619)

2025-09-05 14:40:52 -04:00

trash

feat: adds trash support (soft deletes) (#12656)

2025-07-25 09:08:22 -04:00

troubleshooting

docs: add dependency troubleshooting docs (#13385)

2025-08-06 11:19:32 -04:00

typescript

docs: payload proper nouns (#11792)

2025-03-21 09:04:11 -04:00

upload

feat: adds disableListColumn and disableListFilter to imageSize admin props (#13699)

2025-09-09 11:56:57 -04:00

versions

docs: updates image paths to new screenshots (#13461)

2025-08-14 13:15:35 -04:00

.prettierrc.json

chore: bump prettier, re-enable prettier for docs (#11695)

2025-03-14 17:13:08 +00:00