> For the complete documentation index, see [llms.txt](https://docs.cloutly.com/reviews-sdk-for-marketplace-websites/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cloutly.com/reviews-sdk-for-marketplace-websites/cloutly-embed/embed-overview.md).

# Embed Overview

Overview of embedding Cloutly inside your app.

Cloutly Embed lets you render the Cloutly app in your product using an iframe while your backend controls auth and tenancy through signed JWT claims.

## Core flow

1. Your frontend requests an embed JWT from your backend.
2. Your backend signs a short-lived token with your Cloutly signing key.
3. Cloutly validates the token, then upserts user and business records.
4. The iframe session loads in the scoped business context.

```mermaid
flowchart LR
  user[Your User] --> app[Your Frontend]
  app --> api[Your Backend]
  api -->|signed JWT| embed[Cloutly Embed]
  embed -->|upsert user and business| session[Embedded Session]
  session --> app
```

## Required JWT claims

* `externalUserEmail`
* `externalBusinessId`
* `businessDisplayName`
* `firstName`
* `lastName`
* `role`
* `smsLimits`
* `iat`
* `exp`