> 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

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`
