--- title: "Update Page" method: PUT path: "/pages/{id}" tags: ["Page"] --- # Update Page `PUT /pages/{id}` Update an existing page. Works for both internal and external (SDK) pages. > **Closed Alpha note:** updating an **external** page requires external (SDK) page access — not yet enabled for all workspaces (403 otherwise). Request access at https://developers.myclickfunnels.com/page/code-support. Internal page updates are unaffected. Field availability depends on the page type — see `PageParametersUpdate` for the full breakdown. Sending an internal-only field on an external page (or `external_url` on an internal page) returns 422 with an explicit list of the rejected field names — never silently ignored. **`sort_order`** (optional, top-level): Reposition the page within its funnel. Zero-based. Ignored when `funnel.show_page_step_id` is also provided. **`funnel.show_page_step_id`** (optional): Swap the page onto an existing show page step. The previous page on that step becomes an orphan. Shared by both page types. **`external_url`** (external pages only): Update the external URL. The SDK token is preserved. ## Path parameters - `id` string, required ## Query parameters - `expand[]` string[] ## Request body - object - `page` PageParametersUpdate — Update parameters for a page. Field availability depends on the page type: **Shared (both internal and external pages):** `name`, `description`, `sort_order`, `funnel.show_page_step_id`, `show_page_step.product_ids`. **Internal-only** (returns 422 if sent on an external page): `markup`, `theme_id`, `current_path`, `seo_title`, `seo_description`, `seo_index`, `head_code`, `footer_code`, `custom_css`, `live_data_changes`. **External-only** (returns 422 if sent on an internal page): `external_url`. - `name` string — Page name of the editable page element. - `description` string, nullable — A short description of the page (max 1000 characters). - `sort_order` integer — Reposition the page within its funnel. Zero-based. `0` moves it to the first position. The page must belong to exactly one funnel step; pages with zero or multiple funnel steps return 422. Out-of-bounds values return 422. Ignored when `funnel.show_page_step_id` is also provided — the swap target's position takes precedence. - `funnel` object — Optional funnel mutation block. On update, only `show_page_step_id` is supported — swap the page onto an existing show page step. - `show_page_step_id` union — The ID of an existing show page step to attach this page to. The page previously linked to that step becomes an orphan (kept in the workspace, no longer linked to any step). Shared by both internal and external pages. - integer - string - `seo_title` string, nullable — Custom title for search engine results. Internal pages only — returns 422 on external pages. - `seo_description` string, nullable — Custom meta description for search engine results. Internal pages only — returns 422 on external pages. - `seo_index` boolean — Whether search engines should index this page. Internal pages only — returns 422 on external pages. - `head_code` string, nullable — Custom code to inject into the page's section. Internal pages only — returns 422 on external pages. Set to null to clear existing code. - `head_code_mode` 'append' | 'replace' — How to handle head_code. 'append' adds to existing code (default), 'replace' overwrites. Internal pages only. - `footer_code` string, nullable — Custom code to inject before the closing tag. Internal pages only — returns 422 on external pages. Set to null to clear existing code. - `footer_code_mode` 'append' | 'replace' — How to handle footer_code. 'append' adds to existing code (default), 'replace' overwrites. Internal pages only. - `custom_css` string, nullable — Raw CSS to apply at the page level (no