# SDK Troubleshooting (/docs/sdk-troubleshooting)



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

Quick checklist [#quick-checklist]

* SDK integration is active in EarlySEO
* Article status is published (not draft)
* `EARLYSEO_SITE_ID` matches the site in EarlySEO

No articles on /blog [#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] [#404-on-blogslug]

Possible causes:

* Slug does not exist 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 data

Environment variable not picked up [#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 [#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](/docs/article-theming)

CORS or fetch errors [#cors-or-fetch-errors]

Possible causes:

* Custom proxy misconfiguration

Fix:

* EarlySEO handles cross-origin requests automatically
* Remove custom proxy temporarily and test direct fetch

Pagination issues [#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 [#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

Still stuck? [#still-stuck]

Share these details with support:

* Site ID
* Article slug
* Frontend URL
* Which guide you followed: [Next.js SDK Guide](/docs/next-sdk) or [React SDK Guide](/docs/react-sdk)
* Any console/network errors

Copy/paste diagnostics template [#copypaste-diagnostics-template]

Use this template when contacting support:

```text
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):

Console errors:

Network errors:

Recent changes before issue started:
```