Skip to main content
By the end, your published app will rank higher in search engines — and the SEO rating in the Publishing tool will reflect it. After every successful publish, Replit runs an SEO audit and shows an SEO rating. If the rating has room to grow, one click hands the specific issues to Agent. For most builders, the workflow is just: publish → glance at the rating → ask Agent to optimize. For details on how the rating is calculated (Lighthouse audit, what each rating means, supported deployment types), see SEO Rating.

​
Optimize with SEO Agent

SEO Agent runs a technical SEO audit on your published app and turns each finding into a one-click fix. It lives in the Growth pane in the Project Editor and is available to builders on a paid plan. Follow these steps to scan your app and apply the fixes.
1

Publish your app to unlock Growth

SEO Agent works on a published app. Until you publish, the Growth pane is locked and prompts you to Go to Publishing. Publish from the Agent chat or the Publishing tool, then return to the Growth pane.
The Growth pane showing the locked state with the heading Publish your app to unlock Growth tools and a Go to Publishing button

Before you publish, the Growth pane is locked with a Go to Publishing prompt

2

Run scan with Agent

Open the Growth pane and find the SEO Rating card. Select Run scan with Agent to start a technical SEO audit of your project. A scan usually takes a few minutes.
A zoomed-in view of the SEO Rating card with a red rectangle highlighting the Run scan with Agent button

Select Run scan with Agent in the SEO Rating card to start the audit

3

Fix with Agent or Fix all with Agent

When the scan finishes, the issues appear in a table with Severity (Low, Medium, or High) and Status (Unresolved) columns, grouped into categories such as AI Readiness, Crawlability & Discovery, Landing Page Rendering & Metadata, and Performance Proxies. Expand any issue to read what SEO Agent found.Apply fixes at whatever granularity you want:
  • Fix with Agent on a single issue hands just that item to Agent.
  • Fix with Agent on a category fixes every issue in that group.
  • Fix all with Agent sends every issue to Agent at once. The Fix all issues button in the chat does the same thing.
The scan results table grouped by category with severity and status columns, a red rectangle highlighting the Fix all with Agent button, and per-category Fix with Agent buttons

After the scan, fix issues individually, by category, or all at once with Fix all with Agent

4

Agent works through the fixes

Agent spins up a fix task for each issue and works through them in the background, so you can keep building. Rows update to Fix in progress, and a Go to task link lets you open any task to follow along.
The scan results table with issue rows now showing a Fix in progress status and Go to task links while Agent works

Agent spins up fix tasks; issue rows show Fix in progress with a Go to task link

5

Apply changes to main version

When a fix is ready, the task shows a Ready for review state. Review the changes, then select the green Apply changes to main version button to merge the fix into your app. Republish to refresh your SEO Rating against the new build.
A zoomed-in view of the Ready for review task footer with a red rectangle highlighting the green Apply changes to main version button

Review each fix and select Apply changes to main version to merge it

You can also skip the scan UI entirely. Open Agent and say “optimize my SEO” — Agent will pick up your latest results and start working through them.
Common fixes Agent will apply:
  • Add or rewrite missing or generic <title> tags so each page has a unique, descriptive title.
  • Add a meta description to every page.
  • Add descriptive alt text to images.
  • Set the lang attribute on the <html> element.
  • Make sure links have discernible text (no “click here” or empty anchors).
  • Add a robots.txt and a sitemap.xml.
  • Add a viewport meta tag for mobile rendering.
  • Improve color contrast on text that fails accessibility checks.
  • Add Open Graph and Twitter card meta tags so links to your app preview well on social platforms.

​
Best practices for an SEO-optimized app

Whether you ask Agent to handle these for you or write them yourself, these are the highest-leverage things to get right:
  • Give every page a unique title and meta description. Aim for titles under 60 characters and descriptions around 150–160 characters.
  • Use semantic HTML. Wrap your layout in <main>, <header>, <nav>, and <footer>. Use <h1> once per page and step heading levels in order.
  • Add alt text to every image. Describe what the image shows, not just what it is.
  • Generate a sitemap.xml and robots.txt. Ask Agent to create both so search engines know what to crawl.
  • Add Open Graph and Twitter card tags. Control how your app looks when shared on social media.
  • Use a custom domain. A branded domain builds trust with both visitors and search engines. See Add a custom domain.
  • Pick the right deployment type. For content-heavy sites, Static Deployments deliver pre-rendered HTML that search engines parse instantly.
  • Add structured data. JSON-LD markup helps search engines show rich results for products, articles, FAQs, and events.
  • Keep your app fast. Optimize images, avoid render-blocking scripts, and lean on Replit’s hosting to keep response times low.
A simple way to apply most of these in one shot:

​
Improve it next

SEO Agent

Run a technical SEO audit and apply one-click fixes for crawlability, metadata, and structured data.

SEO Rating

See exactly how the rating is calculated, what each rating means, and which deployment types support it.

Add a custom domain

Move your app to your own domain — a branded URL builds trust with both visitors and search engines.

Static Deployments

The best deployment type for content-heavy, SEO-critical sites.

Publishing Geography

Choose where your app runs to keep response times low for your audience.

​
Need further help?

  • The rating didn’t update after a republish: wait a minute or two — the audit runs asynchronously after the deployment goes live, and the badge refreshes when results land.
  • The rating is the same after Agent’s changes: ask Agent which specific Lighthouse items it addressed, then check the badge tooltip for the items that are still flagged.
  • Some pages have a lower rating than others: the badge surfaces the lowest rating across all crawled URLs. Ask Agent to focus on the specific page Lighthouse flagged.
  • You don’t see a rating on a published app: SEO ratings only run for public web-facing deployment types (Autoscale, Reserved VM, Static). Scheduled and private deployments don’t produce a rating.