What should I do if a Webflow integration is not working on my website?

If a Webflow integration is not working, it usually means there's a configuration issue, a script conflict, or a third-party service error. Here's a step-by-step guide to troubleshoot and fix the issue.

1. Identify the Integration Type

• Determine if the integration is custom code (like analytics or plugins) or uses a built-in Webflow integration (like Mailchimp, Google Analytics).
• Check if the issue is with form connections, embeds, analytics, scripts, or external apps.

2. Check Custom Code Placement

• Go to Project Settings → Custom Code and verify if you’ve placed the code in the correct section (Head or Body).
• Make sure there are no syntax errors in the custom code.
• Ensure all necessary script files are loading via HTTPS and from valid sources.

3. Confirm Publish and Cache

• Re-publish the site after adding or updating custom code or integrations.
• Clear your browser cache or try visiting your site in an incognito window.

4. Test Third-party Service Status

• Visit the website or status page of the service (e.g., Mailchimp status page) to see if the third-party service is down or experiencing issues.
• Confirm that your credentials (API keys, form actions, etc.) are valid and active.

5. Check Webflow Form Settings

• If using a service like Mailchimp or Zapier, make sure:
• Your form action URL is correct.
• The correct field names are being used (case-sensitive).
• You’ve disabled Webflow’s default form behavior if using a custom endpoint.

6. Open Developer Tools (Browser Console)

• Use Developer Tools (Inspect → Console tab) to check for:
• Script errors (e.g., 404 for missing files, CORS issues, JavaScript exceptions).
• Warnings or blocked content due to incorrect Content Security Policies.

7. Verify Site Settings and Domains

• Go to Project Settings → Hosting and ensure:
• Your domain is properly connected if the integration relies on a custom domain.
• SSL is enabled, if the integration requires secure connections (e.g., Stripe).

8. Disable Conflicting Scripts or Extensions

• Temporarily remove or isolate other custom scripts to test if they’re interfering.
• Try disabling browser extensions during testing to rule out local conflicts.

9. Review Webflow's Integration Docs

• Visit Webflow University (https://university.webflow.com) for official setup guides for specific integrations.
• Double-check the setup instructions for services like Google Tag Manager, Finsweet attributes, or social embeds.

10. Contact Support

• If the issue persists, contact Webflow Customer Support with:
• A link to your Webflow project (Editor link if possible).
• A detailed explanation of what’s broken.
• Screenshot(s) or console logs showing the error.

Summary

To fix a broken Webflow integration, first identify the integration type, verify custom code, check the third-party service and publish status, and use browser tools to uncover script errors. Re-publishing the site and eliminating script conflicts usually resolves most issues.