---
title: "useConvexClient"
description: "Reference for the advanced helper that returns the active realtime client."
canonical_url: "https://nuxt-convex.onmax.me/api-reference/use-convex-client"
---
# useConvexClient

> Reference for the advanced helper that returns the active realtime client.

`useConvexClient` returns the current `ConvexClient` instance.

## Import

```ts
import { useConvexClient } from 'vue-convex/advanced'
```

In Nuxt, the same helper is available from `#convex/advanced`.

## Signature

```ts
function useConvexClient(): ConvexClient
```

## Behavior

- Throws when no realtime client is connected, which is always the case during SSR
- Intended as an escape hatch when the higher-level composables are not enough

## Related pages

- [useConvexController](https://nuxt-convex.onmax.me/api-reference/use-convex-controller)
- [useConvexHttpClient](https://nuxt-convex.onmax.me/api-reference/use-convex-http-client)


## Sitemap

See the full [sitemap](https://nuxt-convex.onmax.me/sitemap.md) for all pages.
