⚙️ Using OTTO on Custom Replit Sites
✅ What works on a custom Replit site
Search Atlas and OTTO work on a custom-coded Replit website when the live site is public, uses a stable URL, and can be
crawled. Audits, rank tracking, Google Search Console, and Google Analytics do not require WordPress or another CMS.
They use your live domain and the accounts you connect.
OTTO can review the site and recommend fixes. On a custom Replit project there is no CMS connector that writes those
fixes into your code and republishes them for you. You apply approved changes in Replit, then publish the project as you
normally do.
📊 Audits, rank tracking, and Google data
Add the production domain, not a private editor preview, as the project website. Then connect the matching properties:
- Site audit: OTTO crawls public pages, status codes, titles, meta descriptions, headings, links, indexation signals,
and page speed signals it can see from the live response.
- Rank tracking: Tracking follows the keywords and locations you set. It does not depend on how the site was coded.
- Google Search Console: Connect the property that exactly matches the live domain, including https and www or
non-www.
- Google Analytics: Connect the property that already receives traffic from that same domain.
If Google cannot see the site, OTTO cannot use that data either. Confirm the Replit deployment is public, the custom
domain points to it, and the live pages are not blocked by a login, noindex, or a disallow rule in robots.txt.
🛠️ Install the OTTO pixel
The pixel is a small script you place in the site code. Add it to the shared HTML head or layout so it loads on every
public page, including pages you add later. Do not place it only on the homepage.
1. Open the pixel installation instructions inside your Search Atlas project and copy the script.
2. In Replit, open the shared layout, head partial, or base HTML file used by all pages.
3. Paste the script inside the head, before the closing head tag, and publish the site.
4. Open a few live pages and confirm the pixel shows as detected in Search Atlas. Check both the homepage and an inner
page.
If your app is a single-page app, the script must remain present after client-side route changes. Putting it in the root
HTML file usually covers that. A preview URL that changes on every run is not a reliable installation target.
💡 JavaScript content and what OTTO can see
Content that exists in the initial HTML is the safest content for audits and search engines. If titles, descriptions,
headings, or body copy appear only after JavaScript runs, OTTO and Google may see a thin or empty page.
- Keep the title, meta description, canonical tag, H1, and main copy in the server response whenever you can.
- Use one public URL per page, and keep that URL stable after you republish.
- Avoid blocking CSS, JavaScript, or important routes in robots.txt.
- If the site is fully client-rendered, use server rendering or a prerendered HTML response for the pages you want
indexed.
🚀 Automatic recommendations versus manual fixes
OTTO still generates recommendations for a custom site. The difference is deployment.
- Automatic on supported CMS connections: approved fixes can be published by the connector.
- Manual on custom Replit sites: you copy the recommended title, meta description, heading, content, schema, or
internal link into the relevant file, template, or route, then publish from Replit.
Treat OTTO as the source of the change, and your Replit repo as the place the change is saved. After publishing, request
a fresh crawl or wait for the next audit so Search Atlas can confirm the live page changed.
📝 Publishing new pages without a headache
OTTO does not create or upload new Replit pages for you. You add the route or file in the project, publish it, and make
sure it is linked and indexable. A simple template keeps this predictable:
1. Duplicate an existing page template that already contains the pixel, title, meta description, canonical, and H1.
2. Write the new copy and publish the deployment.
3. Add an internal link from a related page already in the site.
4. Include the URL in your XML sitemap if you maintain one.
5. Submit or let Search Console discover the URL, then check it in the next OTTO audit.
New pages are not harder because the site is on Replit. They become difficult only when each page is hand-built
differently, the URL changes after every deploy, or the content never appears in the HTML response.
🔍 Quick checklist
- The production site is public on the final domain.
- Search Console and Analytics properties match that domain.
- The pixel is in the shared head and detected on inner pages.
- Important content is in the HTML, not only injected by JavaScript.
- Approved OTTO fixes are applied in Replit and republished by you.
- New pages reuse one template, stay linked, and keep stable URLs.
If you need further assistance, open the chat widget in the bottom-right corner of the platform and type human teammate
to be instantly connected with a member of our team.