When you publish a web app on Replit, a Search Engine Optimization (SEO) audit runs automatically against your live URLs and surfaces an SEO Score from 0–100 in the Publishing tool. If the score has room to grow, a single click hands the specific issues to Agent so you can fix them in seconds. For most builders, the entire workflow is: publish your app, glance at the score, and ask Agent to “optimize my SEO.” This page explains what is happening underneath and how to get the most out of it.Documentation Index
Fetch the complete documentation index at: https://docs.replit.com/llms.txt
Use this file to discover all available pages before exploring further.
SEO Score is rolling out to all builders. If you don’t see it in your Publishing tool yet, it will appear automatically over the next few days.
What is SEO and why it matters
Search engine optimization (SEO) is the practice of building your site so that search engines like Google can find, understand, and rank it. Strong SEO means your app shows up when people search for what you offer — without paying for ads. A handful of things drive most of your SEO outcomes: clear page titles and descriptions, semantic HTML, fast load times, mobile-friendly layouts, descriptive alt text on images, and a crawlable site structure. Search engines reward sites that are easy to read for both humans and machines. If you are launching a landing page, a marketing site, a blog, a directory, or anything else where discoverability matters, SEO is one of the highest-leverage things you can invest in early.How Replit improves your SEO out of the box
Replit handles a lot of the SEO foundations for you so you can focus on your content and product:- Fast, globally distributed hosting: Replit Deployments serve your app from infrastructure tuned for speed, and you can choose where your app runs with Publishing Geography.
- HTTPS by default: Every published app gets a TLS certificate managed by Replit, which is a baseline ranking signal for search engines.
- Custom domains: Connect your own domain to build trust and brand authority. See Custom Domains.
- Static Deployments for content sites: For marketing pages, blogs, and documentation, Static Deployments deliver pre-rendered HTML that search engines crawl easily.
- Agent writes SEO-aware code: When Agent builds your pages, it produces semantic HTML, accessible markup, and meta tags by default — the same things SEO tools check for.
- The SEO Score feature: An automatic post-publish audit so you always know where you stand, paired with a one-click handoff to Agent to fix what it finds.
The SEO Score feature
After every successful publish, Replit runs a Lighthouse audit against the URLs in your deployment and stores the results. The Publishing tool then displays an overall SEO Score for your app.
Where to find it
Open the Publishing tool on a published app. The SEO Score appears on the deployment overview alongside your other build details. Hover the score to see the specific action items Lighthouse flagged for each page.How to read your score
Replit uses Lighthouse’s standard thresholds:| Score | Status | What it means |
|---|---|---|
| 90–100 | Good | Your app follows SEO best practices. Keep an eye on it after major changes. |
| 50–89 | Needs work | Several issues are limiting how well search engines can understand your app. |
| 0–49 | Poor | Important SEO basics are missing. Fixing them usually takes only a few minutes. |
When the score is calculated
The audit runs automatically after every successful publish. Scoring usually completes within a minute or two of a deployment going live, and the Publishing tool refreshes the badge as soon as results land.Supported deployment types
The SEO Score is calculated for public web-facing deployments where search engines can crawl URLs: Scheduled deployments and private deployments won’t produce an SEO Score because they do not serve public web traffic.Optimize SEO with Agent
When your SEO Score is below 90, an Optimize SEO with Agent button appears next to the score. Selecting it sends the exact action items Lighthouse identified — for every URL it checked — straight to a fresh Agent chat with instructions to fix them. After Agent finishes its changes, republish your app. The SEO Score recalculates against the new build and the badge updates automatically. 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
alttext to images - Set the
langattribute on the<html>element - Make sure links have discernible text (no “click here” or empty anchors)
- Add a
robots.txtand asitemap.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 site on Replit
Whether you ask Agent to handle these for you or write them yourself, these are the highest-impact things to get right on a Replit-built app:- 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.xmlandrobots.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 Custom Domains.
- 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.
Next steps
- Custom Domains — connect your own domain to your published app.
- 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.
- Agent — learn more about working with Agent on your app.