---
template: Example
---

# `useState`

`useState` is an SSR-friendly ref replacement. Its value will be preserved after server-side rendering and shared across all components using a unique key.

::alert{type=info icon=👉}
Learn more about [useState](/api/composables/use-state).
::

::ReadMore{link="/api/composables/use-state"}
::

::ReadMore{link="/guide/features/state-management"}
::

::sandbox{repo="nuxt/framework" branch="main" dir="examples/composables/use-state" file="app.vue"}