# Integrate in Next.js

- Human documentation: [https://docs.univer.ai/guides/docs/getting-started/integrations/nextjs](https://docs.univer.ai/guides/docs/getting-started/integrations/nextjs)

- Agent Markdown: [https://docs.univer.ai/guides/docs/getting-started/integrations/nextjs.md](https://docs.univer.ai/guides/docs/getting-started/integrations/nextjs.md)

- Requested language: `en-US`

- Content language: `en-US`

- Documentation version: `1.0.0-rc.0`

- Source: [docs/getting-started/integrations/nextjs.mdx](https://github.com/dream-num/documentation/blob/dev/content/guides/docs/getting-started/integrations/nextjs.mdx)

---

Start with [installation and basic usage](https://docs.univer.ai/guides/docs/getting-started/installation.md). This example uses Next.js App Router to mount Univer Docs in a container with an explicit height.

Load the editor from a Client Component with `ssr: false`[^ssr]. A `use client` directive alone does not disable prerendering. [Next.js](https://nextjs.org/docs/app/guides/lazy-loading#skipping-ssr).

### Integration Steps

1. Initialize Univer in the `useEffect` hook
2. Destroy Univer in the return function of the `useEffect` hook

### Example

Each mount uses its own child container. Disposal runs in a microtask after the surrounding React cleanup, so nested React roots are not unmounted synchronously during a React commit.

```tsx title="univer-editor.tsx"
'use client'

import { UniverDocsCorePreset } from '@univerjs/preset-docs-core'
import UniverPresetDocsCoreEnUS from '@univerjs/preset-docs-core/locales/en-US'
import { createUniver, LocaleType, mergeLocales } from '@univerjs/presets'
import { useEffect, useRef } from 'react'

import '@univerjs/preset-docs-core/lib/index.css'

export default function UniverEditor() {
  const containerRef = useRef<HTMLDivElement>(null)

  useEffect(() => {
    const host = containerRef.current
    if (!host) return
    const container = document.createElement('div')
    container.style.height = '100%'
    host.append(container)

    const { univer, univerAPI } = createUniver({
      locale: LocaleType.EN_US,
      locales: {
        [LocaleType.EN_US]: mergeLocales(
          UniverPresetDocsCoreEnUS,
        ),
      },
      presets: [
        UniverDocsCorePreset({
          container,
        }),
      ],
    })

    univerAPI.createDocument({})

    return () => {
      queueMicrotask(() => {
        univer.dispose()
        container.remove()
      })
    }
  }, [])

  return (
    <div ref={containerRef} style={{ height: 600 }} />
  )
}
```

```tsx title="page.tsx"
'use client'

import dynamic from 'next/dynamic'

const UniverEditor = dynamic(() => import('./univer-editor'), { ssr: false })

export default function Page() {
  return <UniverEditor />
}
```

[^ssr]: Server-side rendering (SSR) runs rendering code before the browser loads the page. Browser-only APIs such as `window` and the DOM are unavailable there; a Client Component may still be prerendered unless SSR is disabled for that editor component.