Connecting Webflow

Webflow connects with an API token you make in your site's settings. Pages go into one of your CMS collections, usually the blog, as items like the rest.

What it needs

• A CMS collection with a rich text field, such as a blog. Add one in Webflow first if you don't have it.
• The site published to its domain at least once.
• Admin access to the Webflow site to make the token, and an admin seat in the tracker to connect.

Connecting

Step 1: the token.

1. In Webflow, open your site's Site settings, then Apps & integrations.
2. Under API access, click Generate API token.
3. Set CMS to Read and write and Sites to Read-only. Leave the rest at No access.
4. Copy the token and paste it into the tracker, then press Check token. Webflow only shows it once.

Step 2: where pages go. We match your collection's fields for you; change any that look wrong.

• Collection: the one pages go into. They go live at that collection's folder and then the page's address.
• The page: the rich text field the body goes in. Then the title, summary, meta description and header image fields, each optional.
• Webflow needs these on every post: if the collection requires a field we have nothing for (an author, a category), pick a default for it.

Press Save and continue. You can change these later with Change where pages go, without a new token.

Publishing

Choose Live now or Save as a Webflow draft instead; a draft is a staged item in the collection. Webflow copies every image to its own hosting. Tables, embeds and the page's schema go in as embed blocks, so they survive if you edit the item in Webflow. Only a live item counts on the question board.

When something fails

• Webflow didn't accept that token, or it can't read your CMS. Make a new token with CMS on Read and write and Sites on Read-only.
• That token belongs to a different site. Make it in this site's own settings. A token works for one site.
• No CMS collection with a rich text field. Add a blog collection in Webflow first.
• Webflow rejected our token. It was deleted, or made without CMS access. Reconnect with a new one; your collection and field choices are kept.
• The collection is gone, or it now requires a field we can't fill. Reconnect Webflow to choose another collection or a default.
• The collection already has a post at that address. Nothing was published, because Webflow would have moved the page to a different address without saying so. Change the address, or, if that post is this page, say so.
• No published domain yet. Publish the site once in Webflow, then try again.
• It requires an image and this page has none. Add an image to the page first.
• Webflow is rate-limiting us, or didn't answer in time. Wait a minute. On a timeout, check the collection before trying again, in case the page went up.

Disconnecting

On the Publishing page, press Disconnect. That deletes our copy of the token. To stop the token working in Webflow too, delete it under Site settings, Apps & integrations, API access.