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

..

array.mdx

docs: performance (#13068)

2025-07-14 23:55:16 -04:00

blocks.mdx

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

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

checkbox.mdx

docs: performance (#13068)

2025-07-14 23:55:16 -04:00

code.mdx

docs: performance (#13068)

2025-07-14 23:55:16 -04:00

collapsible.mdx

feat: select field filter options (#12487)

2025-05-22 15:54:12 -04:00

date.mdx

docs: performance (#13068)

2025-07-14 23:55:16 -04:00

email.mdx

docs: performance (#13068)

2025-07-14 23:55:16 -04:00

group.mdx

docs: performance (#13068)

2025-07-14 23:55:16 -04:00

join.mdx

feat(graphql): allow to pass count: true to a join query (#13351)

2025-08-01 18:05:54 +03:00

json.mdx

docs: performance (#13068)

2025-07-14 23:55:16 -04:00

number.mdx

docs: performance (#13068)

2025-07-14 23:55:16 -04:00

overview.mdx

fix: presentational-field types incorrectly exposing hooks (#11514)

2025-09-10 18:05:59 +00:00

point.mdx

docs: performance (#13068)

2025-07-14 23:55:16 -04:00

radio.mdx

docs: performance (#13068)

2025-07-14 23:55:16 -04:00

relationship.mdx

docs: performance (#13068)

2025-07-14 23:55:16 -04:00

rich-text.mdx

docs: performance (#13068)

2025-07-14 23:55:16 -04:00

row.mdx

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

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

select.mdx

docs: performance (#13068)

2025-07-14 23:55:16 -04:00

tabs.mdx

docs: performance (#13068)

2025-07-14 23:55:16 -04:00

text.mdx

docs: performance (#13068)

2025-07-14 23:55:16 -04:00

textarea.mdx

docs: performance (#13068)

2025-07-14 23:55:16 -04:00

ui.mdx

docs: performance (#13068)

2025-07-14 23:55:16 -04:00

upload.mdx

docs: performance (#13068)

2025-07-14 23:55:16 -04:00