Skip to main content

​
SwiftPage quickstart

​
What the app is

SwiftPage is an embedded Shopify app for building and publishing landing pages. Merchants build pages in a visual drag-and-drop editor and publish them to Shopify as native Pages, metaobjects, and metafields. A Theme App Extension block renders the pages as Liquid/HTML/CSS, so the storefront carries no global JavaScript. Read the architecture overview for the runtime and data model.

​
Access scopes

The app requests this scope set (from shopify.app.toml):

​
Extensions

The app ships one Theme App Extension: SwiftPage Renderer (extensions/swiftpage-theme), an app block of type theme targeting the page template. It reads the page’s SwiftPage metafield, preferring the landing-page metaobject and falling back to the legacy layout metafield, and renders each section.

​
Authentication model

  • Merchants reach the app through Shopify’s embedded admin; the SPA calls the API with a Shopify App Bridge session token (JWT).
  • The API verifies each session token (HS256) and derives the shop domain from the dest claim to scope all queries.
  • Shopify webhooks are HMAC-SHA256 verified before any handler runs. See Webhooks.

​
Where the API reference is

The externally reachable surface — health, OAuth, pages, Shopify proxy, billing, feature endpoints, App Proxy, and maintenance — is documented in the API overview.

​
Next steps

  • API overview: endpoints and authentication.
  • Webhooks: topics, verification, and delivery handling.
Pcnaid Documentation › Shopify Ecosystem › SwiftPage › Developer