Forums

Articles
Create
cancel
Showing results for 
Search instead for 
Did you mean: 

REST API support for page content width (narrow/full-width) setting

Daniel Bisque
I'm New Here
I'm New Here
Those new to the Atlassian Community have posted less than three times. Give them a warm welcome!
July 20, 2026

The page content width toggle (narrow vs. full-width) is currently UI-only
(⋯ menu → Full width). Teams managing Confluence pages programmatically —
via REST API, MCP tooling, or automation pipelines — cannot control this
setting, forcing manual intervention on every page.

Proposed: Add a contentWidth property (e.g., "default" | "full") to the
page create/update endpoints:
- PUT /wiki/api/v2/pages/{id}
- POST /wiki/api/v2/pages

This is an increasingly common gap as teams adopt AI-assisted and
API-first documentation workflows.

2 answers

0 votes
Aron Gombas _Midori_
Community Champion
July 21, 2026

@Daniel Bisque 

That is controlled by two content properties, and the good news is that you can manage content properties through the "v2" REST API you are already using! 

REST API v2

POST /wiki/api/v2/pages/{page-id}/properties

Request Body:

JSON
{
  "key": "content-appearance-published",
  "value": "full-width"
}

Similarly, repeat the call for "key": "content-appearance-draft" to ensure consistency  (for the page editor).

0 votes
Dan Breyen
Community Champion
July 20, 2026

Hi @Daniel Bisque welcome to the community.  I don't see a specific issue for this suggestion on Atlassian's Jira Site. I would suggest creating one out there, as that sounds like a good option to have. Having it out there will allow people search for it and vote on it for future consideration in the product.  Feel free to post the number here after you create it, so we could vote for it too.

Suggest an answer

Log in or Sign up to answer
DEPLOYMENT TYPE
CLOUD
PRODUCT PLAN
PREMIUM
TAGS
AUG Leaders

Atlassian Community Events