How to Connect Webflow
Updated
Before You Start#
- You need permission to authorize apps on the Webflow site.
- For new articles, your site needs a CMS collection for blog posts, with a Rich Text field for the article body.
Connect with Webflow#
- Click Install on SEOmatic's Webflow Marketplace page. Or, in SEOmatic, open Connections under Setup in the sidebar, click Add Connection on the Webflow row, then Connect Webflow.
- Sign in to SEOmatic, or create an account. You come straight back to the connection.
- Webflow's consent screen opens. It lists the permissions below. Tick the site this workspace works on and approve.
- If you ticked several sites, SEOmatic lists them. Pick the one to connect within 15 minutes.
- Your site is connected. SEOmatic reads your site and domain from Webflow, so there is nothing to re-enter.
One More Step for New Articles
Right after you connect, SEOmatic asks which collection holds your blog posts. If you skip it, the connection card on Connections says Choose where agent articles go until a collection is chosen; articles your agents write wait in SEOmatic until then. Click Choose a collection, pick it and match the fields. Change it later with Change next to Agent articles publish to.
Choose Where Your Posts Go
- Click the collection that holds your blog posts.
- In Map Blog Fields, match each SEOmatic field to a Webflow field. Title, Content, Slug, Excerpt and Featured Image are required. Content must be a Rich Text field and Featured Image an Image field.
- Map Meta Title and Meta Description if your collection has fields for them. This also lets your agents edit SEO titles on your existing posts.
- Click Confirm Mapping. A message says Blog publishing configured.
The Permissions SEOmatic Asks For#
Webflow's consent screen asks for these seven permissions, and no others:
| Permission | What SEOmatic uses it for |
|---|---|
sites:read | List the sites you granted, and read their domains and last publish time to build your live page addresses |
pages:read | List your static pages and read their SEO settings |
pages:write | Set a static page's SEO title, meta description and Open Graph title and description, and undo them. Nothing else on the page |
cms:read | Read your collections, their fields and items |
cms:write | Create and update collection items, and publish the items SEOmatic changed |
custom_code:read | List the scripts on a page, so SEOmatic finds its own structured data script and leaves every other script as it is |
custom_code:write | Register one small structured data script per static page, add it to that page's head, and remove it again |
SEOmatic never publishes a static page or your whole site. Static page changes are saved in Webflow and go live when you click Publish, so your own unfinished design work never goes live early. To confirm a change went live, SEOmatic loads your published page the way a search engine does.
What Your Agents Can Change on Webflow#
| Where | Your agents change | You do it yourself |
|---|---|---|
| CMS collection items (blog posts and similar) | Name, URL slug, body, and SEO title and meta description when those fields are mapped. The items they change are published | Canonical, noindex, structured data |
| Static pages (Home, About, Pricing) | SEO title, meta description, Open Graph title and description, and structured data (JSON-LD) through one small script, saved in Webflow | Publish your site in Webflow to make them live. Page text, name and URL stay yours |
| New articles | Published live into your chosen collection | |
| Redirects | Add them in Webflow's site settings |
Custom Code#
On static pages, SEOmatic can add structured data (JSON-LD) that describes the page to search engines. Webflow's Custom Code API only accepts JavaScript, so SEOmatic registers one small script per page (under 2 KB, served by Webflow) whose only job is to add that JSON-LD block to the page's head. It makes no network requests and collects nothing. Your own scripts and other apps' scripts are left untouched.
The script goes live the next time you publish your site. Undo the change and SEOmatic removes the script from the page. In Webflow, SEOmatic's scripts are named SEOmaticJsonLd followed by letters and numbers. Webflow only allows custom code on sites with a paid site plan, so on a site without one SEOmatic adds no script: the change waits and says why, and everything else works as usual. Structured data for a CMS collection page, or one that does not fit in 2 KB, is not added this way.
Disconnect or Uninstall#
When you disconnect Webflow in SEOmatic, SEOmatic removes its scripts from every page first, then revokes its access; publish your site so the removal goes live. Your titles, descriptions, collection items and articles stay, because they are ordinary content in your site.
If you uninstall the app from Webflow instead, open Page settings > Custom code on each page that has an SEOmatic structured data script and delete it, then publish:
- In the Webflow Designer, open the Pages panel and click the settings icon next to a page.
- In Page settings, scroll to Custom code.
- Delete the script whose name starts with
SEOmaticJsonLd(older ones start withSeoJsonLd). Leave any other code as it is. - Click Save, repeat for each page that has one, then publish your site.
Fix Connection Errors#
| You see | What to do |
|---|---|
| Webflow granted access but no sites were found... | Start again and tick your site on Webflow's consent screen. |
| Authorization was denied... | You cancelled on Webflow. Click Try again, or Connect Webflow in SEOmatic. |
| Webflow authorization expired. Please connect again. | You took more than 15 minutes to pick a site. Start again. |
| Your role in this workspace cannot connect a CMS... | Ask a workspace Admin or Owner, or ask them to make you a Member. |
| Reconnect to Approve New Permissions in the Webflow dialog | Your Webflow approval is older than the static pages and custom code permissions (connections made before October 17, 2026). Click Reconnect and approve once. |
Reconnecting Keeps Your Collection Choice
A Reconnect for the same site keeps the collection you chose. If you connect a different site, choose the collection again on the connection card.
- Does SEOmatic publish my Webflow site or pages?
- No. It publishes only the collection items it changes. Static page changes are saved and go live when you publish your site in Webflow.
- Do I need a Webflow API token?
- No. SEOmatic connects only by signing in with Webflow and approving access on Webflow's consent screen.
- I have several Webflow sites. Can one workspace use them all?
- No. One workspace connects to one site. Add a workspace for each other site. See add another website.
- Do my agents make changes without asking?
- No, not at first. Workspaces connected through the Webflow app start in Approval mode, so every change waits for your click. You can switch to Assisted (changes that can be undone go live on their own once checks pass, bigger ones wait) or Auto anytime in Settings. See approval modes.
SEOmatic is not affiliated with or endorsed by Webflow, Google or Meta.
Was This Article Helpful?
Still need help?Email contact@seomatic.ai with your site address and a screenshot. A person replies, usually within one business day.