Documentation

Learn how to use Fast SEO Fix to automate your content strategy

๐ŸŽจ Automated SEO - Webflow Integration

Connect Fast SEO Fix to your Webflow site using OAuth 2.0 to automatically publish SEO-optimized blog posts directly to your Webflow CMS collections.

Secure OAuth Integration

Uses Webflow's official OAuth 2.0 API - secure, encrypted, and revocable anytime from your Webflow account.

Prerequisites

  • โœ… Active Webflow account with a site
  • โœ… Published Webflow site (must be published at least once)
  • โœ… CMS Collection created for blog posts
  • โœ… Site with Webflow CMS plan or higher

Step-by-Step Setup

Step 1: Prepare Your Webflow Site

  1. Log into Webflow Designer
  2. Go to CMS โ†’ Collections
  3. Click "Create New Collection"
  4. Name it "Blog Posts" (or your preferred name)
  5. Add the following fields to your collection:
Field NameField TypeRequiredDescription
nameTextโœ… YesPost title (auto-created)
slugTextโœ… YesURL slug (auto-created)
post-bodyRich Textโญ RecommendedMain article content
main-imageImageโšช OptionalFeatured image
excerptPlain Textโšช OptionalShort description
meta-titlePlain Textโšช OptionalSEO meta title
meta-descriptionPlain Textโšช OptionalSEO meta description
categoryPlain Textโšช OptionalPost category
tagsPlain Textโšช OptionalPost tags

Field Names Must Match Exactly!

Webflow is case-sensitive. Use the exact field names with hyphens as shown above (e.g., post-body, not postBody).

Step 2: Publish Your Webflow Site

  1. In Webflow Designer, click "Publish" (top-right corner)
  2. Publish to your staging domain (yoursite.webflow.io) or custom domain
  3. This is a one-time requirement - you won't need to republish after every post

Why Publish First?

Webflow requires your site to be published at least once before you can add CMS items via the API.

Step 3: Connect Webflow to Fast SEO Fix

  1. Go to Dashboard โ†’ Publishing Connections
  2. Click "Add Publishing Connection"
  3. Select "Webflow" from the platform dropdown
  4. Click "Connect Webflow Account"
  5. You'll be redirected to Webflow - click "Authorize"
  6. After authorization, you'll be redirected back to complete the setup:
    • Connection Name: e.g., "My Webflow Blog"
    • Select Site: Choose which Webflow site to publish to
    • Select Collection: Choose your blog posts collection
  7. Click "Complete Setup"

Publishing Your First Post

  1. Generate a blog post in your content calendar
  2. Click "Publish" on the generated post
  3. Select your Webflow connection
  4. Click "Publish Now"
  5. The post will be created in your Webflow CMS collection
  6. Visit your Webflow Editor to review the new post

Troubleshooting

"Site is not published" Error

Problem: You're trying to add CMS items to an unpublished site.

Solution:

  1. Open your site in Webflow Designer
  2. Click "Publish" (top-right corner)
  3. Publish to any domain (staging or custom)
  4. Try publishing from Fast SEO Fix again
"Missing fields" Error

Problem: The error message shows which fields are missing from your collection.

Solution:

  1. Open your site in Webflow Designer
  2. Go to CMS โ†’ Collections โ†’ Select your blog collection
  3. Add the missing fields listed in the error message
  4. Use the exact field names shown (with hyphens)
  5. Try publishing again
No Collections Found

Problem: The setup modal shows "No CMS collections found"

Solution:

  1. Create a CMS collection in Webflow Designer first
  2. Go to CMS โ†’ Collections โ†’ "Create New Collection"
  3. Add at least the basic fields (Name, Slug, and post-body)
  4. Go back to Fast SEO Fix and refresh the setup modal
Posts Not Appearing on Website

Problem: Posts are created in CMS but don't show on your website.

Solution:

  1. Check if you've created a Collection List on your blog page template
  2. In Webflow Designer, add a Collection List element to your blog page
  3. Connect it to your Blog Posts collection
  4. Design the list item to display your post fields
  5. Publish your site
Need Different Field Names?

If your collection uses different field names, you can customize the field mappings by editing your connection settings in the dashboard.

What Gets Published

ContentWebflow FieldDescription
Post TitlenameSEO-optimized title
URL SlugslugClean, SEO-friendly URL
Article Contentpost-bodyFull HTML content with formatting
Featured Imagemain-imageAI-generated blog image
ExcerptexcerptShort description for previews
Meta Titlemeta-titleSEO meta title (60 chars)
Meta Descriptionmeta-descriptionSEO meta description (160 chars)
CategorycategoryPrimary category
TagstagsRelevant keywords and topics

Best Practices

  • Create a Collection Template: Design a blog post template in Webflow to properly display your published content
  • Test with Draft Posts: Test your first few posts as drafts to ensure formatting looks correct
  • Use Consistent Field Names: Stick to the recommended field names for easiest setup
  • Set Up Pagination: Configure pagination in Webflow for your blog listing page
  • Add Collection List: Create a Collection List on your blog index page to display all posts

Security & Privacy

  • Your Webflow OAuth credentials are encrypted and stored securely
  • You authorize once per Webflow workspace
  • You can revoke access anytime from your Webflow account settings
  • Each customer connects their own Webflow account independently
  • We only request the minimum required permissions (sites:read, cms:write, assets:write)

Need Help?

If you encounter any issues not covered here, check the error message for specific guidance or contact our support team.