Prerequisites
Before connecting, make sure you have:- A Webflow account with at least one published site
- A CMS collection on that site (or you can create one during setup)
- A Webflow personal access token with the following scopes:
sites:read,sites:write,cms:read,cms:write
You need a site-level token, not a workspace token. Site tokens are created under Site Settings → Apps & integrations → API access in the Webflow dashboard.
Connect your Webflow account
1
Open the Webflow integration page
In XLR8.ai, go to Settings → Integrations → Webflow (or navigate directly to
/settings/integrations/webflow).2
Generate a Webflow personal access token
In a separate tab, open your Webflow site dashboard and go to Site Settings → Apps & integrations → API access.Click Generate API token, give it a name such as “XLR8 Integration”, and grant Read and Write access for all four scopes:
sites:readsites:writecms:readcms:write
3
Paste the token and connect
Back in XLR8.ai, paste the token into the Webflow personal access token field and click Connect with API token.XLR8.ai validates the token by calling the Webflow API and retrieving your sites. If the token is valid, the connection status changes to Connected and your first site is selected automatically.
Configure your site and collection
After connecting, the integration page shows a Connected status with your Webflow site name. Configure where your content will be published before you use the publish action.Select a site
Use the Webflow Site dropdown to choose which of your Webflow sites receives published content. Switching the site reloads the available collections automatically.Select a default collection
Use the Default Collection dropdown to choose the CMS collection that XLR8.ai will publish content into. This collection is used by default every time you publish a piece of content. If you don’t have a suitable collection yet, click Create Collection to create one directly from XLR8.ai.Create a collection
1
Click Create Collection
Select the target site first, then click Create Collection next to the collection dropdown.
2
Enter a name and optional slug
Enter a base name for the collection — XLR8.ai automatically prefixes it with
XLR8- to keep it identifiable in your Webflow dashboard (for example, XLR8-Blog Posts).Optionally enter a URL slug. If you leave the slug empty, it is generated from the name. The collection is created with Name and Body fields.3
Confirm
Click Create Collection. XLR8.ai creates the collection in Webflow and selects it as the default automatically.
Collections created from XLR8.ai include a Name field and a Body field. If you need additional fields (such as author, category, or tags), add them in the Webflow CMS editor after creation.
Publish content to Webflow
Once your site and collection are configured, you can publish any piece of generated content to Webflow.1
Open a content item
Navigate to Content and open the piece of content you want to publish.
2
Select Publish to Webflow
Click the Publish to Webflow action. XLR8.ai uses your configured default collection.
3
Review the slug
A URL slug is generated from your content title. You can customize it before confirming. Slugs must be lowercase, hyphen-separated, and unique within the collection.
4
Confirm and publish
Click Publish. XLR8.ai creates a CMS item in your Webflow collection. Content is published live immediately.
Check sync status
After publishing, XLR8.ai tracks whether your local content has changed since the last sync to Webflow. If you edit the content in XLR8.ai after publishing, the content view shows a local changes indicator. This means your Webflow CMS item is out of date relative to the current version in XLR8.ai. To push the latest version to Webflow, use the Update (or re-publish) action. XLR8.ai sends the updated fields and marks the content as synced.Disconnect Webflow
To remove the Webflow integration from your account:- Go to Settings → Integrations → Webflow.
- Click Disconnect.
- Confirm the prompt.
Troubleshooting
Connection fails with 'Invalid token or missing required scopes'
Connection fails with 'Invalid token or missing required scopes'
Your token is missing one or more required scopes. Go to Webflow → Site Settings → Apps & integrations → API access, revoke the existing token, generate a new one, and make sure you enable Read and Write for
sites:read, sites:write, cms:read, and cms:write.No sites appear after connecting
No sites appear after connecting
Your token must be a site-level token, not a workspace-level token. Site-level tokens are generated from within a specific site’s settings, not from the Webflow workspace dashboard. Create a new token from Site Settings → Apps & integrations → API access.
No collections appear for my site
No collections appear for my site
The selected site may not have any CMS collections. In Webflow, go to CMS → Collections for that site and create at least one collection. Then return to XLR8.ai and reload the collections list. Alternatively, use Create Collection in XLR8.ai to create one directly.
Slug validation error when publishing
Slug validation error when publishing
Slugs must contain only lowercase letters, numbers, and hyphens. They cannot start or end with a hyphen, and must be unique within the collection. Edit the slug to remove any special characters or spaces, and try again.
Content published but changes aren't visible on the live site
Content published but changes aren't visible on the live site
Webflow may require a site publish after CMS item changes. Go to your Webflow site dashboard and click Publish to push the changes live. If the issue persists, check that your token has
sites:write scope — without it, automatic site publishing after content changes is not possible.Disconnect succeeded but the item is still in Webflow
Disconnect succeeded but the item is still in Webflow
Disconnecting XLR8.ai only removes the integration credentials — it does not delete CMS items from Webflow. To remove published items, delete them directly from the Webflow CMS editor.
Related
Content generation
Generate AI-optimized content ready to publish to Webflow.
Content optimization
Improve existing content before pushing it to your Webflow site.
Settings
Configure your company profile and blog URL monitoring.
Quick start
New to XLR8.ai? Start here.