Publish Directly to Webflow CMS
Automatically publish and synchronize researched, SEO-optimized blog articles directly into your Webflow CMS Collection using Webflow's Data API v2. Articles go straight to your live site without requiring a separate site-wide republish.
Direct Live Publishing
Articles go straight to your live Webflow collection item via /items/live without requiring a manual site-wide republish.
Intelligent Auto-Mapping
Heuristic detection maps your collection’s Rich Text, Image, Summary, and Date fields with zero manual configuration.
Single H1 & Footnotes
Guarantees clean heading hierarchy and includes WonderRank’s verified source citations and FAQ accordions.
1. Generate Your Webflow API Token
WonderRank connects securely to Webflow using a scoped Site API Token:
- In your Webflow Dashboard, open your site's settings and navigate to Apps & integrations → API access.
- Under API access tokens, click Generate API token.
- Give your token a name (e.g.,
WonderRank Publishing). - Set the following permissions:
- CMS:
Read and write(required to create and update collection items). - Sites:
Read-only(required to list your collections and verify custom domains). - All other APIs can remain on No access.
- CMS:
- Click Generate token and copy it immediately. Webflow only reveals the full token once.
2. Connecting in WonderRank
Once you have your Webflow token, linking your website takes less than 30 seconds:
- Open Dashboard → Integrations and click Connect Webflow.
- Paste your Webflow API Token and click Fetch Sites & Collections. WonderRank automatically queries Webflow Data API v2 to discover your accessible CMS collections.
- Articles Collection: Select your blog collection (e.g. "Blog Posts" or "Articles").
- Publishing Mode: Choose between:
- Publish Live: Creates the item directly on your live site using
/items/live. - Staged Draft: Stages the item as a draft in Webflow CMS for visual inspection before going public.
- Publish Live: Creates the item directly on your live site using
- Click Connect & Map Webflow. WonderRank saves the configuration and validates the target collection schema.
3. Automatic Field Mapping
WonderRank inspects your collection’s schema and maps article components automatically without requiring manual field mapping:
| WonderRank Field | Target Webflow Field Heuristic | Type | Description |
|---|---|---|---|
| Title | name | PlainText | Webflow's built-in item Name field. Rendered as single <h1> in your template. |
| Slug | slug | PlainText | Webflow's built-in item Slug field (e.g. how-to-scale-seo). |
| Article Body | First RichText field | RichText | Sanitized HTML containing introductory prose, H2 subsections, FAQ accordions, and source citations. |
| Featured Image | First Image field | Image | High-resolution banner image URL and descriptive alt text. |
| Meta Description | post-summary, summary, excerpt, meta-description, seo-description, description | PlainText | SEO meta description & blog card summary. Bind this to your Webflow template's Meta Description setting. |
| SEO Page Title | seo-title, meta-title, page-title | PlainText | Optional custom SERP title tag. Skipped cleanly if your collection does not have this field. |
| Published Date | published-date, publish-date, published-on, post-date, date | DateTime | ISO 8601 publication timestamp. |
* Note: Fields your collection does not have are safely skipped, and extra fields in your collection stay untouched. Republishing an article updates the existing Webflow item in-place without creating duplicates.
4. Webflow Blog Template & SEO Settings (Articles Only)
WonderRank exclusively publishes blog articles into your selected CMS collection (at /{collection-slug}/{article-slug}) and never creates or modifies static layout pages. Configure your Webflow Collection Template once so every published article renders with clean SEO tags:
- Single H1 Heading Hierarchy: On your Blog Posts Collection Template page in Webflow Designer, bind a single
<h1>element to the collection'sNamefield, and bind a Rich Text element below it to your body field. WonderRank's HTML body starts with the introduction and uses<h2>–<h3>tags so your page never has duplicate H1s. - Bind SEO Title & Meta Description: Open Pages → CMS Collection Pages → Blog Posts Template Settings → SEO Settings. Bind Title Tag to
seo-title(orName) and Meta Description topost-summary(orsummary). - Bind Open Graph Share Image: Under Open Graph Settings on the same template, set Open Graph Image URL to pull from your collection's
Main Imagefield.
I am designing a Webflow CMS Blog template for my site. My automated SEO engine (WonderRank) publishes articles directly into my Webflow CMS Blog Posts collection via Webflow Data API v2. Help me configure my Webflow Blog Collection & Template Page for maximum SEO performance: 1. Collection Fields: - "Name" (built-in) -> Article H1 title - "Slug" (built-in) -> URL slug - "Post Body" (Rich Text, slug: post-body) -> Full HTML article body (includes H2-H4 headings, tables, FAQ accordions, and source citations) - "Main Image" (Image, slug: main-image) -> Featured banner image & alt text - "Post Summary" (Plain Text, slug: post-summary) -> Meta description & blog card excerpt - "SEO Title" (Plain Text, slug: seo-title) -> Optional custom meta title - "Published Date" (Date/Time, slug: published-date) -> Publication timestamp 2. Template Page Structure (Strict Single H1): - Bind the page's single <h1> element to the "Name" field. - Below the header/byline, bind a Rich Text element to "Post Body". Do not put an H1 inside the Rich Text element. 3. Collection Template SEO Settings (Page Settings -> SEO Settings): - Set Title Tag to pull from "SEO Title" (or "Name"). - Set Meta Description to pull from "Post Summary". - Set Open Graph Image URL to pull from "Main Image".
5. Troubleshooting Webflow Publishing
400 Bad Request: Missing Required Field
If your Webflow collection has custom fields set as "Required" that WonderRank does not provide (e.g., custom author ID or category reference), Webflow will reject the publish. Change those custom fields to optional in Webflow Collection Settings.
429 Too Many Requests (Rate Limit)
Webflow limits API calls to 60 requests per minute per site token. When publishing large batches of scheduled articles, WonderRank automatically applies exponential jitter backoff to prevent dropped items.
Webflow Token Expiration
Webflow site tokens expire after 365 days of continuous inactivity. Regular publishing from your WonderRank Content Plan keeps your token active automatically.
Table of Contents
Ready to connect?
Connect your Webflow CMS in 30 seconds with automatic collection detection.
Configure Integrations →