bcquality/microsoft/knowledge/ui/show-caption-false-allowed-on-non-editable-fields.md
Jesper Schulz-Wedde b6da405376 Improve partner onboarding and documentation navigation
Lead with a complete plugin quick start and add task-oriented usage, troubleshooting, customization, and contribution guides. Preserve the broader plugin framing, correct conflicting contract guidance, support Agents folder reviews, and align repository validation. Convert existing sample references to clickable links without changing knowledge rules.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
2026-09-09 17:25:29 +02:00

1.1 KiB

bc-version domain keywords technologies countries application-area
all
ui
show-caption
non-editable
content
accessibility
al
w1
all

ShowCaption = false on non-editable fields

Description

When a field is explicitly non-editable (Editable = false), it serves as content rather than as a form field. In that case, ShowCaption = false is acceptable: there is no input control whose label could be lost. The combination signals to a reviewer (and to the platform) that the field displays a value standalone — for example a status message or a description that is meaningful on its own.

This exception does not extend to dynamically editable fields. A field with Editable = SomeBooleanExpression may be editable at runtime and must keep its caption.

Best Practice

If you want to hide a field's caption, pair ShowCaption = false with a literal Editable = false. Use this pattern only for content fields that do not act as labels for other fields in the same layout container.

See sample: show-caption-false-allowed-on-non-editable-fields.good.al.