Technical SEO Checklist for Crypto and Web3 Websites

S

Sandy

Head of Content · Block AI

Quick Answer

Most crypto project websites have serious technical SEO problems that prevent indexing and citation. This checklist covers everything from robots.txt to Core Web Vitals, built specifically for Web3 projects.

Crypto project websites are built by developers optimizing for decentralization and performance, not for search engine crawlability. The result is a predictable set of technical SEO problems that affect the vast majority of projects — and that are straightforward to fix once you know where to look.

1. Robots.txt and Crawler Access

Check your robots.txt at yourdomain.com/robots.txt. The most common problem in crypto projects: a Disallow: / rule inherited from a development configuration that made it to production, or a blanket disallow that blocks all user agents including Googlebot, Bingbot, PerplexityBot, and GPTBot.

The correct configuration for a project that wants search and AI visibility:

User-agent: *
Allow: /

Sitemap: https://yourdomain.com/sitemap.xml

If you want to block specific paths (admin panels, API endpoints, wallet connection flows):

User-agent: *
Disallow: /admin/
Disallow: /api/
Disallow: /app/

Sitemap: https://yourdomain.com/sitemap.xml

Never block Googlebot, Bingbot, PerplexityBot, or GPTBot specifically — these are your citation sources.

2. Indexability of Key Pages

Use Google Search Console (free) to check which pages are indexed. Common indexability problems in crypto sites:

Noindex tags: sometimes added to prevent staging site indexing, then left in production. Check every important page for a noindex meta tag — the tag looks like: <meta name="robots" content="noindex">.

Canonical tag errors: a page canonicalizing to a different URL tells Google the current URL is a duplicate. Every page should canonicalize to itself unless it's genuinely a duplicate.

JavaScript rendering: if your site is a React or Next.js SPA that requires JavaScript to render content, some pages may appear blank to crawlers. Check by viewing source (not inspect element) — if the body tag is empty except for a root div, Google has to render your JS, which adds latency and can cause incomplete indexing.

3. Sitemap Quality

Your sitemap should include every page you want indexed. Check:

  • All blog posts and educational articles are included
  • All service/product pages are included
  • URLs in the sitemap match the canonical URLs
  • The sitemap is submitted in Google Search Console and Bing Webmaster Tools
  • The sitemap is accessible (not behind authentication)

For crypto sites with many dynamic pages (individual token pages, user profiles), use sitemap index files to break the sitemap into manageable chunks.

4. Core Web Vitals

Google uses Core Web Vitals as ranking signals. The three key metrics:

Largest Contentful Paint (LCP): time for the main content block to load. Target: under 2.5 seconds. Common causes of slow LCP on crypto sites: large hero images, unoptimized font loading, excessive JavaScript blocking the render.

Interaction to Next Paint (INP): how quickly the page responds to user interaction. Target: under 200ms. Heavy JavaScript animation libraries and Web3 wallet connectors often cause INP problems.

Cumulative Layout Shift (CLS): visual stability during loading. Target: under 0.1. Caused by images without explicit dimensions, dynamically injected content, and late-loading fonts.

Test with PageSpeed Insights (free) for lab measurements and Google Search Console for field data across real users.

5. Mobile Optimization

Google indexes the mobile version of your site first. Test your project pages at 375px viewport width. Common failures: navigation menus that overflow, token price tables that don't scroll horizontally, wallet connection flows that require desktop-sized modals.

6. Structured Data

At minimum, implement: Article schema on blog posts (with your organization as publisher), FAQ schema on any page with question/answer content, and Organization schema on your homepage.

Validate with Google's Rich Results Test before deploying. Schema errors are invisible without testing and prevent the structured data from being used.

7. HTTPS and Security Headers

All crypto project sites should have HTTPS (this is baseline). Additionally, implement: Content Security Policy headers, X-Frame-Options (prevents clickjacking), and ensure no mixed content warnings (HTTP resources loaded on HTTPS pages).

8. Internal Linking

Your educational content should link to your product pages, and your product pages should link to relevant educational content. Isolated pages — those with no internal links pointing to them — are harder to discover and rank. Create a content hub structure where cluster articles link to each other and to the main pillar page.