updateAdminAppearanceSection

Writes a section's published values — what the storefront draws immediately. To hold a change back until publishing, use createAdminAppearanceSectionDraft instead.

Input fields

Field	Type	Required	Description
id	ID	Yes	Section IRI.
name	String	Yes	Section name.
type	String	Yes	One of the six section types.
sortOrder	Int	Yes	Published position.
channelId	Int	Yes	Channel the section belongs to.
themeCode	String	Yes	Theme the section belongs to.
status	Boolean	No	Published on/off. Keeps the current value when omitted.
locale	String	No	Locale the options belong to. Falls back to the channel locale.
options	Iterable	No	Published content for the locale. Keeps the current content when omitted.

Payload fields

The updated section, same fields as adminAppearanceSection, with message set.

Use cases

• Rename or reposition without touching content — send the required fields and leave options out.
• Publish content straight away — send options for copy that is already final, skipping the draft cycle.

Best practices

• Send every required field, including the ones you are not changing. The input is a full form; a missing one is a validation error rather than a no-op.
• options writes one locale. Repeat the mutation per locale with a different locale.
• Switching a section to footer_links follows the one-per-channel rule and is rejected when the channel already has a footer.

Permissions

Requires appearance.sections.edit.