Data API Tools

Pages

The Pages tool provides comprehensive page management capabilities, including listing pages, retrieving metadata, updating SEO settings, and managing localized content across multi-language sites.

When to use

Use the Pages tool to:

  • List all pages: Get an overview of all pages in a site
  • Manage SEO: Update meta titles, descriptions, and Open Graph data
  • Update page settings: Modify slugs, publishing status, and page configuration
  • Work with localization: Retrieve and update content in secondary locales
  • Audit pages: Check page structure, content, and metadata

Tool details

Tool name: data_pages_tool

Available actions

List pages

List all pages within a site with metadata including IDs, titles, and slugs.

Action: list_pages

Parameters:

ParameterTypeRequiredDescription
site_idstringYesUnique identifier for the site
localeIdstringNoLocale ID for localized sites
limitnumberNoNumber of pages to return
offsetnumberNoPagination offset

Returns: Array of pages with basic metadata

Example usage:

List all pages for site [site_id]

Get page metadata

Retrieve comprehensive metadata for a specific page including SEO settings, Open Graph data, and publication status.

Action: get_page_metadata

Parameters:

ParameterTypeRequiredDescription
page_idstringYesUnique identifier for the page
localeIdstringNoLocale ID for localized content

Returns: Complete page metadata including:

  • SEO title and description
  • Open Graph title, description, and image
  • Page slug
  • Publishing status (draft/published)
  • Last modified date
  • Custom metadata

Example usage:

Get metadata for page [page_id]

Update page settings

Modify page settings including SEO metadata, Open Graph data, slug, and publishing status.

Action: update_page_settings

Parameters:

ParameterTypeRequiredDescription
page_idstringYesUnique identifier for the page
localeIdstringNoLocale ID for localized content
bodyobjectYesPage settings to update (WebflowPageSchema)

Updatable fields:

  • title - Page title (SEO)
  • description - Meta description
  • seoTitle - Custom SEO title
  • openGraphTitle - OG title for social sharing
  • openGraphDescription - OG description
  • openGraphImage - OG image URL
  • slug - Page URL slug
  • isHomePage - Whether this is the site’s home page

Example usage:

Update page [page_id] to set SEO title to "Best Coffee in Seattle" and description to "Discover artisan coffee roasted locally"

When updating SEO fields, ensure titles are under 60 characters and descriptions under 160 characters for optimal search engine display.

Get page content

Retrieve the complete content structure and data for a page, including all elements and their properties. Useful for localization workflows.

Action: get_page_content

Parameters:

ParameterTypeRequiredDescription
page_idstringYesUnique identifier for the page
localeIdstringNoLocale ID for localized content
limitnumberNoNumber of elements to return
offsetnumberNoPagination offset

Returns: Page content structure with all elements and properties

Example usage:

Get the full content structure for page [page_id]

Getting page content returns extensive data. Use limit and offset parameters for large pages to prevent context overflow.

Update static content

Update content on static pages in secondary locales by modifying text nodes and property overrides.

Action: update_static_content

Parameters:

ParameterTypeRequiredDescription
page_idstringYesUnique identifier for the page
localeIdstringYesLocale ID for the secondary locale
nodesarrayYesArray of content nodes to update

Example usage:

Update the hero headline on page [page_id] in Spanish locale to "Bienvenidos"

This action is specifically for localization. You must specify a secondary locale (not the primary locale).

Best practices

Use get_page_metadata before updating to see current values and avoid overwriting important data.

  • Keep titles under 60 characters
  • Keep descriptions under 160 characters
  • Use unique titles and descriptions for each page
  • Include target keywords naturally
  • Write compelling, actionable descriptions

Changing page slugs affects URLs and can break links. Update redirects when changing slugs on published pages.

When working with multi-language sites, always specify the locale ID to ensure you’re updating the correct language version.

Use limit and offset parameters when getting page content for pages with many elements to avoid overwhelming your AI agent’s context.

Limitations

  • Localization: update_static_content only works with secondary locales, not the primary locale
  • Static pages only: Content updates work on static pages; CMS template pages require different tools
  • Publishing: Changes to page settings and content must be published to appear on the live site
Sites

List and publish sites

Collections

Manage CMS content

Designer Pages

Manage page structure in the Designer