Site OptimizersPro

    Install on Webflow

    Add the SEO Agent script to Webflow and check that it works.

    This guide shows you how to add the SEO Agent script to your Webflow site, step by step. You don't need to know how to code. The SEO Agent is part of Pro.

    Why it helps

    • One script lets outwrite.ai check your Webflow pages and apply the SEO fixes you approve, such as clearer page titles and descriptions, without editing each page.
    • You install it once. After that, you apply, check and undo fixes from outwrite.ai.

    Before you start

    • Your site has an active paid Webflow Site plan, or sits in a paid Workspace (Core, Growth, Agency or Freelancer). Webflow only allows custom code on these plans.
    • You can edit the site's settings (Site manager or Designer role).
    • Your website address in outwrite.ai Brand is your published custom domain, including www if your site uses it.

    Step 1: Copy your script from outwrite.ai

    1. In outwrite.ai, open Site Optimizers → SEO Agent in the sidebar.
    2. Click Connect your website. If you set this up before, click Install website script at the top right instead. If you then see Create website script, click it.
    3. Click Copy script.

    Your script is one line of code that starts with <script defer src= and ends with </script>. Copy the whole line and don't change any part of it.

    Step 2: Add the script to Webflow

    The script goes in your site's head: a hidden section at the top of every page where settings and scripts live. Visitors never see it. Webflow calls this Head code.

    1. Open Site settings for your site (from your Webflow dashboard, or from the Webflow menu in the Designer).
    2. Click the Custom code tab.
    3. Paste your script into the Head code box.
    4. Click Save changes.
    5. Open the site in the Designer, click Publish, make sure your custom domain is selected, and publish.

    Step 3: Check the installation

    1. Open your website's homepage in a new browser tab. Visiting your site tells outwrite.ai to look for the script.
    2. In outwrite.ai, go to Site Optimizers → SEO Agent. If the badge at the top right already says Installation verified, you're done.
    3. Otherwise, click Install website script, then Check installation. When it works, you see Found on your homepage.
    4. Your first audit starts by itself. It uses 0 credits, and you can leave the page while it runs.

    How to tell it's working

    What you see in outwrite.aiWhat it means
    Setup neededoutwrite.ai hasn't found the script on your homepage yet
    Installation verifiedThe script is on your homepage
    Finding your website’s pages…outwrite.ai is listing your pages. This is free
    Running your free first auditYour pages are being checked. This uses 0 credits
    A number of issues and three scoresThe audit is done. Review your fixes

    Webflow limits

    • Custom code doesn't run in the Designer preview. Always check your published site.
    • Your webflow.io staging address won't be checked unless it is the website saved in Brand. Publish to your custom domain.
    • Because the code is site-wide, it also covers your CMS pages, such as blog posts.
    • To make a fix permanent, you can also enter it in the page's SEO settings in Webflow. The next scan then shows it as Fixed in website source.

    If outwrite.ai can't find the script

    • Saved, but not published. Saving site settings doesn't update your live site. Publish to your custom domain.
    • The script isn't in the page code. outwrite.ai reads your homepage's code directly. A script added later by a tool such as Google Tag Manager, or placed in an Embed element, isn't found. Use Head code as shown above.
    • Your homepage redirects. Your homepage must open at the website address saved in Brand. If it redirects (for example from example.com to www.example.com), outwrite.ai shows the final address. Before the script is verified, change Website under Brand → Edit business to that address and choose Check installation again; your script stays the same. Once the script is verified, contact support to move the SEO Agent to a different address.
    • Verified, but fixes stay at Awaiting page visit. Open the page in a normal browser window. Ad blockers, privacy extensions and cookie banners that hold back scripts can stop the script from reporting back.

    How to remove the script

    1. Open Site settings → Custom code.
    2. Delete the script line from Head code and click Save changes.
    3. Publish your site.

    All SEO Agent changes stop on the next page load, and your pages go back to how they were. Your Webflow content isn't affected. If you plan to reinstall later, undo any fixes you don't want first. Fixes you haven't undone apply again once the script is back.

    Common questions

    Will the script slow down my site?

    It loads with defer, which means the browser finishes reading your page before running it.

    What does the script send to outwrite.ai?

    Only the page address, to load that page's fixes, and whether each fix appeared. It doesn't send page text, form entries or cookies, and it doesn't track visitors.

    Is this the same as connecting Webflow for publishing?

    No. The script lets the SEO Agent fix your pages. Connect Webflow lets outwrite.ai publish articles to your site. You can use either one, or both.

    Related guides

    Need a hand with your workspace?Get help