Install & permissions

Steps

1. Open tidyAgent from the Webflow Marketplace listing and install it on your site.
2. Sign in to Webflow if prompted, then approve the tidyAgent Data Client permission screen (scopes listed below).
3. You land in the hosted tidyAgent dashboard for that site — complete onboarding and run a knowledge scan via Webflow Data APIs.
4. Publish the Webflow site so custom code (the chat widget) goes live for visitors.
5. Optional: pick a plan in tidyAgent billing (card checkout). Review / testing mode may unlock Pro without checkout.

Permissions we request

These match the OAuth scopes tidyAgent requests at install. Approve only if you are an admin on the Webflow site.

• authorized_user:read

  Identify the Webflow user who installed tidyAgent and keep the workspace tied to that account.

• sites:read

  Read site name, domains, locales, and connection details for the workspace.

• sites:write

  Required by Webflow for site-level Custom Code apply/remove during install and disconnect.

• pages:read

  Read page metadata (title, SEO description, published path) from GET /v2/sites/{site_id}/pages. tidyAgent does not call GET /v2/pages/{page_id}/dom.

• custom_code:read

  GET /v2/sites/{site_id}/registered_scripts and GET /v2/sites/{site_id}/custom_code to see whether the chat widget script is already registered or applied.

• custom_code:write

  POST /v2/sites/{site_id}/registered_scripts/inline (loader that loads https://agent.tidyflowapp.com/widget.js) and PUT /v2/sites/{site_id}/custom_code to apply or remove the chat widget. Does not use hosted script registration.

• cms:read

  Read CMS collections and items for knowledge (plan-scoped).

• ecommerce:read

  Read ecommerce catalog data when your site has a store (plan-scoped).

After install

• Uninstall from tidyAgent Settings → Uninstall & remove widget. The App deletes its applied Custom Code via the Webflow API, then prompts you to Publish so the live bubble disappears. You do not need to manually edit Custom Code when uninstall succeeds.
• Reopen tidyAgent anytime from the Webflow Marketplace or https://agent.tidyflowapp.com/webflow.
• Widget look and agent settings live in the tidyAgent dashboard (AI Agent), not in Webflow site styles.
• Full user guide: https://agent.tidyflowapp.com/docs/webflow

Notes

• tidyAgent is hosted at agent.tidyflowapp.com — Webflow is not the operator of the dashboard or AI.
• Knowledge uses Webflow Data APIs only: site profile, page metadata (not page DOM), CMS, and ecommerce when available. tidyAgent does not crawl or scrape the published domain.
• Custom code uses one path only: POST …/registered_scripts/inline (loader → https://agent.tidyflowapp.com/widget.js) then PUT …/custom_code at the footer. Hosted registration is not used. Publish is required for visitors to see the bubble.
• Exact scope mapping: https://agent.tidyflowapp.com/docs/webflow and webflow-extension/SCOPE_MAPPING.md
• User guide: /docs/webflow — Terms: /terms?platform=webflow — Privacy: /privacy?platform=webflow.