> ## Documentation Index
> Fetch the complete documentation index at: https://rollout.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Embedded Apps

> Put your app on the contact page of the CRMs your customers already use.

Your users live in their CRM. With Embedded Apps, your app shows up right there,
in a panel on the contact they're looking at, so they never have to switch tabs
or copy a name into your product.

![A CRM contact page for Jordan Rivera, with an Apps panel beside the activity feed showing the Easy Cash Offers app: the contact's name, home address and a Generate offer button](https://mintcdn.com/rollout/l0jLuVTIfNu5jYvw/images/embedded-apps/app-on-contact-page.png?fit=max\&auto=format\&n=l0jLuVTIfNu5jYvw\&q=85\&s=acd9781c4017d4cd06c4da65bbdf5217)

An app, Easy Cash Offers, on a contact in a CRM. The CRM shown is an illustration: each CRM places its apps in its own layout.

You build one web page. Rollout loads it in an iframe on the CRM's contact
page, and adds a **signed context** to its URL that tells you who is looking at
which contact. Your server checks the signature, and your page shows whatever
your app has for that contact: a cash offer, a valuation, a transaction's
status, a call log.

If you've built an embedded app for Follow Up Boss, this follows the same model,
and the same codebase can serve both. How much changes depends on what your app
reads from the context. See
[Have a Follow Up Boss embedded app? Start here](https://rollout.com/docs/embedded-apps/coming-from-follow-up-boss.md).

## How a launch works

```mermaid theme={null}
sequenceDiagram
  actor Agent
  participant CRM as CRM contact page
  participant Rollout
  participant App as Your app
  Agent->>CRM: Opens a contact
  CRM->>Rollout: Which apps does this agent have on?
  Rollout->>Rollout: Signs a context for your app
  Rollout->>App: Loads your URL in an iframe,<br/>with ?context=…&signature=…
  App->>App: Your server verifies the signature
  App-->>Rollout: Your page loads Rollout's app script,<br/>which says it's ready
  Rollout-->>Agent: Shows your app, sized to its content
```

Every time the agent opens another contact, Rollout loads your page again with
a new context for that contact.

## What you build

* **A web page** at an `https` URL, which Rollout loads in an iframe.
* **A signature check** on your server, with your Rollout client secret. About
  ten lines of code.
* **One script tag**, Rollout's app script, which tells Rollout your page is
  ready and how tall it is.

Then you list your app in CRMs' marketplaces. Each CRM reviews your app, and
once it's approved, the CRM's users can turn it on for themselves or their
whole team.

## Start here

> [card] [Quickstart](https://rollout.com/docs/embedded-apps/quickstart.md)
>
> Get a working app showing a signed context in about 15 minutes.

> [card] [Verify the context](https://rollout.com/docs/embedded-apps/verify-the-context.md)
>
> Check every launch's signature, expiry and replay, in Node or Python.

> [card] [Context fields](https://rollout.com/docs/embedded-apps/context-fields.md)
>
> Everything Rollout tells you about the agent and the contact.

> [card] [Build the page](https://rollout.com/docs/embedded-apps/build-the-page.md)
>
> Sizing, framing headers, sign-in and the iframe's limits.

> [card] [List your app](https://rollout.com/docs/embedded-apps/list-your-app.md)
>
> Submit your app to CRMs' marketplaces and track its review.

> [card] [Read CRM data](https://rollout.com/docs/embedded-apps/read-crm-data.md)
>
> Use the Universal API to read more about the contact than the context carries.

## Current limits

* Apps show on **contact** (person) records only.
* Rollout sets up each app publisher. [Contact us](https://rollout.com/docs/contact.md) to get started.
* No emails are sent when your listing is reviewed. Check the dashboard.
* An app has one URL for every marketplace. There is no versioning, no
  per-app secret and no sandbox marketplace yet.

> [!NOTE]
>
> Building a CRM, and want to run a marketplace of apps like these?
> [Contact us](https://rollout.com/docs/contact.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.