SDK Troubleshooting

Use this page when your SDK integration is configured but content is not rendering as expected.

Quick checklist

• SDK integration is active in EarlySEO
• Article status is published (not draft)
• EARLYSEO_SITE_ID matches the site in EarlySEO
• Frontend reads from media.earlyseo.com

No articles on /blog

Possible causes:

• Wrong site ID
• No published articles yet
• Published to a different site/workspace

Fix:

1. Verify site ID in env or provider config
2. Publish one test article from EarlySEO
3. Reload /blog

404 on /blog/[slug]

Possible causes:

• Slug does not exist in CDN yet
• Page path does not match your basePath

Fix:

1. Open /blog and copy a valid slug
2. Check your route and basePath config
3. Republish the article once to refresh CDN files

Environment variable not picked up

Possible causes:

• Missing .env.local entry
• Dev server not restarted
• Wrong variable name

Fix:

• Use exactly EARLYSEO_SITE_ID
• Restart dev server after env changes
• Log the value in development to confirm

Content styles look broken

Possible causes:

• Raw mode enabled without custom CSS
• Theme CSS overriding article classes

Fix:

• Start with styled mode (default)
• If using htmlMode: "raw", add your own CSS rules
• Review theming options in Article Theming

CORS or fetch errors

Possible causes:

• Custom proxy misconfiguration
• Wrong CDN URL

Fix:

• Use default CDN (https://media.earlyseo.com)
• Remove custom proxy temporarily and test direct fetch

Pagination issues

Possible causes:

• Incorrect basePath
• Client-side route conflicts

Fix:

• Keep basePath aligned with your routes
• Confirm ?page= query param is preserved in links

Integration says connected but content is stale

Possible causes:

• Recent publish not completed
• Old browser cache

Fix:

• Republish latest article from dashboard
• Hard refresh browser
• Recheck list JSON and article JSON URLs directly

Still stuck?

Share these details with support:

• Site ID
• Article slug
• Frontend URL
• Which guide you followed: Next.js SDK Guide or React SDK Guide
• Any console/network errors

Copy/paste diagnostics template

Use this template when contacting support:

Site ID:
Frontend URL:
Framework: Next.js | React | Other
Guide followed: /docs/next-sdk | /docs/react-sdk

Issue summary:

Observed behavior:

Expected behavior:

Article slug (if relevant):

List JSON URL tested:
https://media.earlyseo.com/site/{siteId}/articles/page-1.json

Article JSON URL tested:
https://media.earlyseo.com/site/{siteId}/article/{slug}.json

Console errors:

Network errors:

Recent changes before issue started: