# useSession

**Kind:** Function

A hook for connecting a React component to the current session. This returns a `Session`
instance and will re-render your component whenever the session changes (e.g. when the current user's
permissions change or when the current user's name changes).

`useSession` should meet most of your needs for working with `Session`. If you need more granular
control of when your component updates or want to do anything other than re-render, the lower
level `useWatchable` hook might help.

```js
import {useSession} from '@airtable/blocks/interface/ui';

// Says hello to the current user and updates in realtime if the current user's
// name or profile pic changes.
function CurrentUserGreeter() {
    const session = useSession();
    return (
        <React.Fragment>
            Hello {session.currentUser?.name ?? 'stranger'}!
        </React.Fragment>
    );
}
```

**Returns:** `Session`