Documentation

/

Setup guide

Substack Sync · setup guide

Substack Sync

Sync your Substack publication's posts into a Framer CMS collection. No API key, no login.

Introduction

Substack Sync imports the public posts of a Substack publication into a Framer CMS collection. You do not need an API key or a login. You only need the web address of the publication.

It works with any *.substack.com address and with a custom domain. Setup takes about a minute.

Part 1: Connect your publication

Step 1: Open the plugin on a CMS collection

The plugin makes and manages its own Framer CMS collection. Your posts go into that collection.

  1. In your Framer project, open the Substack Sync plugin

  2. The plugin sets up a managed CMS collection for your posts

  3. On the welcome screen, click Get Started

Step 2: Find your publication URL

This is the public address of your Substack.

  1. Open your Substack in a browser

  2. Copy the address from the URL bar, for example yourpublication.substack.com

  3. A custom domain such as news.yoursite.com also works

Step 3: Connect

Enter the URL. Then the plugin checks it.

  1. Paste your address into the Publication URL field

  2. Click Connect Publication

  3. The plugin checks the address before it saves it, to make sure that it can read your posts. So you know immediately if something is wrong

Part 2: Sync your posts

Step 1: Run your first sync

  1. On the Sync tab, click Sync Now

  2. The plugin loads your list of posts and gets the content of each post. Then it writes everything into the collection

  3. When it finishes, it shows how many posts it added

Step 2: Choose how syncs behave (optional)

Open the Settings tab to choose a sync mode:

  • Full Sync adds new posts and updates changed posts. It also removes posts that are no longer on your Substack

  • Add Only adds and updates posts. It never removes a post

Both modes leave the Hidden and Featured fields as they are. You control those fields in the CMS. The plugin never writes to them.

What gets synced

Each post brings its title, subtitle, body, excerpt, cover image, publish date, post URL, author, tags and word count.

Free plan and licensing

The free plan syncs your 3 most recent posts, so you can try the plugin. To sync your full publication, activate a license:

  1. Click the ? button at the bottom of the plugin, then Activate License

  2. Buy a license for $29. It is a one-time payment with lifetime access

  3. Paste your license key and click Activate

You are ready

Run Sync Now each time you publish or edit a post on Substack. The plugin gets only what changed, so the next syncs are fast. Your posts show as CMS items that you can connect to any Framer layout.

If something is not right, check that:

  • The publication URL is correct and public, with no login wall

  • Your Substack has at least one published post

  • You are connected to the internet

Support

For setup help and troubleshooting, email us at support@framerlabs.com.

f

+

We improve framerlabs all the time. Come back often to see our updates.