Install on WordPress.com
Add the SEO Agent script to WordPress.com and check that it works.
This guide shows you how to add the SEO Agent script to a site hosted by WordPress.com, step by step. You don't need to know how to code. The SEO Agent is part of Pro.
If you run WordPress on your own hosting, use Install on WordPress instead.
Why it helps
- One script lets outwrite.ai check your WordPress.com 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 is on a paid WordPress.com plan. WordPress.com only allows plugins on paid plans (Personal, Premium, Business and Commerce), and you need a plugin to add the script.
- You are an administrator of the site.
- Your website address in outwrite.ai Brand matches the address visitors see, including
wwwif your site uses it.
Step 1: Copy your script from outwrite.ai
- In outwrite.ai, open Site Optimizers → SEO Agent in the sidebar.
- 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.
- 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 WordPress.com
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. The easiest way to add code there is the free WPCode plugin.
- Log in to WordPress.com and open your site's dashboard.
- Go to Plugins and search for WPCode.
- Open the plugin named "WPCode (Insert Headers and Footers)", then install and activate it.
- In the left menu, go to Code Snippets → Header & Footer.
- Paste your script into the Header box.
- Click Save Changes.
Step 3: Check the installation
- Open your website's homepage in a new browser tab. Visiting your site tells outwrite.ai to look for the script.
- In outwrite.ai, go to Site Optimizers → SEO Agent. If the badge at the top right already says Installation verified, you're done.
- Otherwise, click Install website script, then Check installation. When it works, you see Found on your homepage.
- 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.ai | What it means |
|---|---|
| Setup needed | outwrite.ai hasn't found the script on your homepage yet |
| Installation verified | The script is on your homepage |
| Finding your website’s pages… | outwrite.ai is listing your pages. This is free |
| Running your free first audit | Your pages are being checked. This uses 0 credits |
| A number of issues and three scores | The audit is done. Review your fixes |
WordPress.com limits
- On the free plan you can't install plugins, so you can't add the script. A Custom HTML block won't work either: it only affects one page, and script code may be removed.
- Pages can be cached for a short time. If outwrite.ai doesn't find the script right away, wait a few minutes and check again.
- Login, admin, account, cart and checkout pages are never changed.
- To make a fix permanent, you can also enter it in your page's SEO settings. The next scan then shows it as Fixed in website source.
If outwrite.ai can't find the script
- The plugin isn't active. Check that WPCode shows as active under Plugins, and that you clicked Save Changes.
- 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 isn't found. Add it with WPCode as shown above.
- Your homepage redirects. Your homepage must open at the website address saved in Brand. If it redirects (for example from
example.comtowww.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
- In your dashboard, go to Code Snippets → Header & Footer.
- Delete the script line from the Header box.
- Click Save Changes.
All SEO Agent changes stop on the next page load, and your pages go back to how they were. Your WordPress.com 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 WordPress.com for publishing?
No. The script lets the SEO Agent fix your pages. Connect WordPress.com lets outwrite.ai publish articles to your site. You can use either one, or both.
