Webflow

A Webflow channel is one CMS collection on one of your Webflow sites — your Blog Posts, a Changelog, Case Studies. Post to it and Ocoya adds a new item: the title becomes its Name and slug, the text its rich text body, the first image its main image. One Webflow connection can give you a channel for every collection on the sites you chose. Webflow can also start a workflow: an item published on your site can be shared to your other channels a moment later. See Webflow in workflows below.

​

Before you start

You need a Webflow site that uses the CMS and has at least one collection, and you need to be allowed to install apps on it. Webflow asks you to choose the sites while you connect, and Ocoya can only ever reach the collections on those sites. It can read and write CMS items; it cannot change your pages, styles or settings.

​

Connect Webflow

Connecting again — to add more sites, or to change the values for required fields — updates the same connection, and your existing channels keep working.

​

How posts appear

If the text’s first line repeats the title, it’s left out of the body so the title isn’t shown twice. Links you added to the post that aren’t already in the text go at the end. Text written in Markdown — headings, lists, quotes, bold, links — arrives as real rich text. Plain text keeps its paragraphs and line breaks, and web addresses become clickable links. Image alt text is passed to Webflow, which keeps its own copy of each image. Every other field is left alone, unless the collection requires it.

​

Required fields

Webflow collections often require fields an article doesn’t have — an Author reference, a Category option, a region. When you connect, Ocoya opens Fill in required Webflow fields and asks what every post from Ocoya should use:

• References (an author, a category, tags) are chosen from the items in the referenced collection.
• Options are chosen from the field’s own choices.
• Numbers, text, links, emails and phone numbers take a fixed value.

Choose Save, or Not now to do it later by connecting Webflow again. Until a value is chosen, the post editor warns you before you schedule a post to that collection, and the post fails if it goes out anyway.

​

Live or draft

Posts from the post editor are published live: the item goes up on your site the moment it posts. Only that one item is published — the rest of your site, and any unpublished changes to your pages, stay as they are. In a workflow, the Publish to Webflow step lets you choose under In Webflow: This is separate from the step’s Save as draft switch, which keeps the post in your Ocoya planner without sending it to Webflow at all. A published post links to its page: your site’s address, the collection’s slug and the item’s slug. A draft links to your site.

​

What you can post

A post needs text or at least one image.

​

Webflow’s limits

​

Deleting a post

Deleting a published post in Ocoya unpublishes the item from your site and removes it from the collection. Webflow has no trash for CMS items, so it can’t be restored there. Items your team created are never touched.

​

Webflow in workflows

Webflow works at both ends of a workflow. Publish to Webflow is an action. Choose the collection, a Title (its slug is made from it), the caption, and In Webflow: Publish live or Keep as draft. New item published in a Webflow collection is a trigger. Choose a collection channel, and the workflow runs once for each item published. How the trigger behaves:

• A published item runs within moments. Webflow tells Ocoya as soon as an item is published or changed. Ocoya also checks once a day, in case a notice went missing.
• Nothing before you switch the workflow on counts. Items already on your site are left alone.
• Each item runs once. Editing or republishing it later doesn’t post it again.
• Up to 10 items run per check. Publish fifty at once and they’re worked through over the next checks, oldest first.

Every field of the item is available to the steps after the trigger, written in lowercase with underscores: a field called Post Summary becomes {{trigger.post_summary}}. You can also use: Rich text arrives as plain text, options as their names, and references as item IDs rather than names. Leave a following Post to step’s caption or media empty and it uses {{trigger.text}} and the item’s images.

​

Disconnecting

Disconnecting a Webflow channel in Ocoya stops Ocoya posting there. Items it already published stay on your site. To remove Ocoya from Webflow entirely, revoke the Ocoya app in your Webflow account’s apps and integrations settings. Every Webflow channel from that connection then shows Reconnect needed the next time it posts.

​

Common problems

”… has required fields with no value chosen: …” The collection requires a field Ocoya has no value for. Connect Webflow again and fill in Fill in required Webflow fields, or make the field optional in Webflow. ”… has required fields Ocoya cannot fill: …” The collection requires a field of a type Ocoya can’t fill, such as a date or a file. Make it optional in Webflow, or post to another collection. ”… has no Rich text field for the post’s text.” Add a Rich text field to the collection in Webflow. ”… requires an image.” The collection’s main image is required. Add an image to the post. “Webflow no longer accepts this connection. Reconnect Webflow.” Ocoya was revoked in Webflow. Reconnect — see Reconnect a channel. “Ocoya can no longer reach this Webflow site.” The site was left out the last time you connected. Connect Webflow again and choose it. “Webflow cannot find this collection.” The collection was deleted, or its site is no longer shared with Ocoya. Pick a different channel. “Webflow is rate limiting requests.” Webflow asked Ocoya to slow down. The post can be retried in a minute. “Webflow authorization was declined.” You selected Cancel on Webflow’s screen. Connect again and choose Authorize. A collection I expected isn’t listed. Check its site was ticked on Webflow’s screen. Connect again to add it.

​

Related