---
title: Troubleshooting
description: Solutions for common issues with @c15t/nextjs — provider errors, missing banners, consent persistence, and more.
---
## SSR Hydration Mismatch
**Symptom:** React hydration warnings, consent banner flashes briefly, or consent state differs between server and client.
**Fixes:**
1. **Missing `ssrData`** — Ensure you're passing the SSR data Promise to the provider. Do **not** `await` `fetchInitialData()` in Server Components:
```tsx title="app/layout.tsx"
import { fetchInitialData } from '@c15t/nextjs';
import ConsentManager from '@/components/consent-manager';
export default function RootLayout({ children }: { children: React.ReactNode }) {
const ssrData = fetchInitialData({ backendURL: '/api/c15t' });
return (
{children}
);
}
```
2. **Stale cache** — If using a CDN or caching layer, ensure the SSR data is fresh per-request and not shared across users.
3. **Debug with `useSSRStatus`** — Check if SSR data was actually consumed:
```tsx
const { ssrDataUsed, ssrSkippedReason } = useSSRStatus();
```
See [Server-Side Data Fetching](/docs/frameworks/next/server-side) for full SSR setup.
## TypeScript Errors
**Common import issues:**
```tsx
// Components and hooks — main entry point
import { ConsentManagerProvider, useConsentManager } from '@c15t/nextjs';
// Server-side data fetching
import { fetchInitialData } from '@c15t/nextjs';
// Headless (hooks only, no components)
import { useConsentManager } from '@c15t/nextjs/headless';
```
If you see type errors after updating, try:
```sh
rm -rf node_modules/.cache
bun install
```
## Still Stuck?
* Enable `debug: true` in provider options for verbose console logging
* Use the [DevTools](/docs/frameworks/next/components/dev-tools) panel to inspect live consent state
* Check the [GitHub issues](https://github.com/c15t/c15t/issues) for known bugs