add_section
ChatGPTAdd authored sections (each a SemanticNode tree plus an optional style artifact, in the vocabulary of the page-authoring guide) to a page: one as section, or up to 4 as sections, saved together in one call and one version; at most 10 sections per page. Appends at the bottom unless position says where the first goes. Validation errors are returned as text and nothing is saved; a success reply means every section is saved. Large sections take longer to build: send fewer per call. Images the sections leave without a usable source are filled from the store's own product photos or the Pexels stock-photo service.
get_drawer_authoring_guide
ChatGPTHow to author or edit a Smart Cart drawer, in parts. Start with "overview" — it states what a drawer cannot express and indexes every component. Then "compose" to write a whole drawer, "style" for theme and styling, "edit" to change an existing one.
get_pagefly_guide
ChatGPTPageFly's own knowledge, one part at a time — how a page is built, how a section is changed, and how a page is judged for conversion. Each part covers one kind of work; the vocabulary it describes is PageFly-specific. Parts: quickstart: the workflow, the minimum vocabulary and one complete section, enough to build a first section. plan compose craft elements style custom-html: the full reference for building a page or a section. edit — changing a section already on a page, in the operations of pageSectionUpdate. optimize — improving a section from its Page Checkup findings. checkup — the rubric for judging a page and reporting the verdict. Use when they say: "build me a landing page" (quickstart, then plan) · "add an FAQ section" (craft, then compose) · "make this section convert better" / "optimize section 3" (optimize) · "change the button colour" (edit) · "check this page" / "what is wrong with my page" (checkup). elementTypes scopes elements/style/edit; sectionTypes scopes craft, which otherwise answers with its index.
preview_page
ChatGPTGet the storefront preview link for a page plus its element outline, whether it is live, and what the store's plan allows for publishing it and measuring its performance. The link renders inside the live theme and needs no login. If the page has never been rendered, it is rendered first and that HTML is saved on the page; nothing existing is overwritten.
preview_section
ChatGPTRender one authored section and return screenshots of it at desktop and mobile width, plus what the deterministic guards corrected. Takes the same section object as add_section and saves nothing — use it to see a section before adding it, and again after a revision. Images the section leaves without a usable source are filled from the store's own product photos or the Pexels stock-photo service. Each call counts toward the store's hourly preview limit.
render_drawer
ChatGPTReturn screenshots of a Smart Cart drawer at desktop and mobile width, rendered by the real storefront runtime over sample cart contents. Use it after creating or editing one, to judge how the drawer actually looks before the merchant publishes it. The drawer itself is not changed. It reads the store's live theme and sample products from Shopify, and creates a Storefront API access token on the store if it has none. Each call counts toward the store's hourly preview limit.
run_mutation
ChatGPTMake one named change to the store's PageFly data: pick the operation, fill its arguments, optionally name the fields to return in select. Operations marked "Asks first" (publishing, unpublishing or deleting, spending credits, starting a trial) return a card and a confirmationId instead of running, and run only when sent again with that confirmationId after the merchant agrees. Read userErrors. Full rules: search_docs Mutation.<operation>.
run_query
ChatGPTRead the store's PageFly data with one named read: pages, a page and its sections, analytics, A/B tests, Page Checkup, cart drawers, bundles, products, collections, images, templates or the store. Pick the operation, fill its arguments, and optionally name the fields to return in select. Read-only. An operation's full rules: search_docs Query.<operation>.
screenshot_page
ChatGPTReturn screenshots of a whole saved page at desktop and mobile width. Use it once the sections are in, to judge the page as one composition — section-to-section rhythm, repeated weight, an accent used only once. For a single section before adding it, use preview_section; for a link the merchant can open themselves, use preview_page. If the page has never been rendered, it is rendered first and that HTML is saved on the page; nothing existing is overwritten. Each call counts toward the store's hourly preview limit. Use when they say: "show me the page" · "how does it look on mobile?" · "did that change work?"
search_docs
ChatGPTRead PageFly's task guides and the fields each type returns, to choose a run_query or run_mutation operation and its select. With no ids it lists every guide and operation, one line each; with ids it returns those in full. A guide may show the GraphQL behind a step: its root field is the operation, its arguments are the arguments.
update_section
ChatGPTReplace the section at position (1-based, as the page outline numbers it) with a newly authored one, keeping its place on the page. The section argument is the same shape add_section takes; validation errors come back as text and nothing is changed. The previous section is overwritten and cannot be restored. Images the section leaves without a usable source are filled from the store's own product photos or the Pexels stock-photo service. Choosing how to change a section: a section the merchant built, or has edited, is changed with run_mutation pageSectionUpdate, which keeps everything its operations do not name. update_section replaces the whole section with a new tree, for a section you authored in this conversation.
add_section
Claudeapply_section_edit
Claudecreate_page
Claudecreate_upgrade_link
Claudedelete_page
Claudedelete_section
Claudeget_ab_test_results
Claudeget_cro_findings
Claudeget_page
Claudeget_page_authoring_guide
Claudeget_page_health
Claudeget_plan_status
Claudeget_section
Claudelist_pages
Claudelist_shop_media
Claudemove_section
Claudepreview_page
Claudepublish_page
Claudesearch_help
Claudesearch_templates
Claudeunpublish_page
Claudeupdate_page
Claudeupdate_section
Claude