Webflow

Make a Webflow site API token with the right permissions, pick your blog collection, match its fields, and see what publishing does.

RankHabit adds each article to a CMS collection on your Webflow site through Webflow's Data API, and publishes that one item. Your site needs a Webflow CMS plan. Connecting never sends anything by itself.

Make a site API token

  • In Webflow, open your site's Site settings → Apps & integrations.
  • Under API access, press Generate API token and give it a name, like RankHabit.
  • Set Sites to Read and CMS to Read and write. RankHabit needs sites:read, cms:read and cms:write. It doesn't need assets:write: your cover goes to Webflow by its address and Webflow copies it.
  • Press Generate token and copy it. Webflow shows it only once.

Make the token in the site you publish to: a site token only sees its own site. We keep it encrypted and never show it again. If a permission is missing, Connect names it.

Connect

  • Article settings → Publishing → Connect → Webflow.
  • Paste the token and press Check token.
  • Pick the collection your posts go to (we choose one named like Blog or Posts first).
  • Check the fields. Title, Slug and Body are required; everything else can be Not mapped and is then skipped.
  • Press Connect Webflow, then Test connection: it saves a draft item and deletes it a minute later.

A new Webflow connection starts with auto-publish off, so only articles you approve go out. Turn it on in Article settings when you're ready. If articles were waiting from before, you're asked “Publish N overdue articles now?”; nothing goes out until you say so.

How fields are matched

RankHabitWebflow field we suggest
TitleName (Webflow's own)
SlugSlug (Webflow's own)
BodyA Rich text field, like Post Body
SummaryPlain text named Summary or Excerpt
Meta titlePlain text named Meta title or SEO title
Meta descriptionPlain text named Meta description
Cover imageAn Image field, like Main Image
Published dateA Date field, like Published Date

Change any of them in Article settings → CMS fields. If your collection makes another field required (an author, say), match it or make it optional in Webflow; otherwise Webflow refuses every post and we say which field it is.

Good to know

  • Publish your Webflow site once from the Designer before the first post, and give the collection a template page that shows the Body field.
  • Only the article's item is published, never the rest of your site.
  • Update on site changes the same item. Its slug is set once and never changed.
  • If someone deletes the post in Webflow, we say so instead of guessing. Retry or Update on site then publishes it again as a new post.
  • Tables become lists in the post, because Webflow's rich text has no tables. The cover goes in by its address and Webflow copies it.
  • When Webflow is busy, we wait as long as it asks and try again a few times before the article shows the reason.