Skip to content
GenPageHelp center

Embed SDK

Serve personalized landing pages from your own website with one script tag. Allow your domain, pick a base path, copy the snippet and manage the embed key.

· For owners and admins

On this page

The Embed SDK lets your own website serve GenPage's personalized pages: you add one script tag to the site, and a visitor who opens an address such as yourdomain.com/pages/spring-launch/acme-jane sees the spring-launch page written for that lead, drawn over your site. Everything is set up under Developers → Embed SDK.

Before you start

  • You need the Owner or Admin role.
  • The SDK is a plan feature. On plans without it the page shows The GenPage SDK is on Scale with Upgrade Plan and Talk to Us buttons; it is included on Scale and Ultimate.
  • Only published pages are served. An unpublished page leaves your site untouched.

Set up the embed

  1. Open Developers → Embed SDK. The Set up the embed guide at the top walks through the five steps with your own values filled in, and the example snippet shows what you will paste. Steps 1 to 3 are done once per site.

    Embed SDK page with the Set up the embed guide highlighted, showing the five steps and an example snippet

  2. Under Allowed domains (required), type the domain you will embed on, for example acme.com, and click Add. Subdomains are included automatically. Until at least one domain is listed, nothing is served: the page warns No domains listed, so nothing can embed your pages right now.

    Allowed domains section with the domain field highlighted and the warning that no domains are listed

  3. Under Base path, keep or change the URL prefix your personalized pages live under. The default is /pages/. The SDK only acts on addresses that start with this path; the rest of your site loads as it does today. Your site must load something at those addresses, even a 404 page, so that the snippet runs. In Framer, Webflow and WordPress, code in the site-wide head runs on the 404 page too; otherwise add a catch-all page under the base path.

  4. Click Save Settings at the bottom of the page. The message Embed settings saved confirms it. Domains and the base path are only stored once you save.

Copy the snippet

  1. Under Landing pages, tick the pages you want to serve and click Get Embed Snippet. The dialog gives you one script tag that carries your workspace, the embed key, the selected pages and the base path; paste it into your site's head once. The button stays disabled until at least one page is ticked and a domain is allowed.

    Landing pages table with page previews and embed URLs, with the Get Embed Snippet button highlighted

A visitor's address decides what they see: the first part after the base path picks the page, the second picks the lead. Without a lead, the page's generic version is served. Views, clicks, scroll depth and session duration are recorded automatically.

The embed key

The Embed key section shows the key that every snippet carries. It proves a request may serve this workspace's pages and is publishable, like a Stripe key, so it is fine that visitors can see it in your page source. Copy copies it; Rotate issues a new one.

Embed key section with the masked key, the Copy button and the Rotate button highlighted

Was this article helpful?

Related articles