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

# Miro embed

> Embed Miro boards in your portal to share visual workspaces with clients.

Miro is a visual workspace for innovation where teams manage and design products, brainstorm, and more. Assembly makes it easy to share Miro boards with your clients directly within your portal. To embed a Miro **Board** in your portal, follow the instructions below.

## App setup

1. Go to **App Library**, and click **+ Add an app** in the top right corner.
2. Select **Miro** in the **Client-facing** section.
3. After clicking on the app, click on **Install** in the top-right.
4. Give the app a name and icon.
5. We recommend setting this up as a **manual** app so that you can embed a different board for each client. If you want this app to be visible to all clients, set this as an **automatic** app.
6. Next, click **Add**. You will be taken to the app's page, where you can set the embed for each client, group, or company.
7. Click **Add** to add your first embed or link. Select the client(s) or company to share the app with.
8. Select **Show as embed** so that the client isn't directed outside of the portal.
9. Next, go to the Board you want to share in your Miro account.
10. To embed a Board, click **Share** in the top right corner.
11. On the **Invite** tab, set the permissions to **Anyone with the link**.
12. Then, click the **Embed** tab and copy the iframe code.
13. Go back to the app page in Assembly, paste the copied iframe code into the content box, and click **Save**.

<Note>
  Miro only allows **view-only** embeds on their free plan. You can enable collaboration on public boards by upgrading your plan.
</Note>

## Frequently asked questions

<AccordionGroup>
  <Accordion title="What if my app does not embed?">
    **Restricted Embeds** Some websites or applications have a policy that restricts link or iframe embeds in external applications. If you try to embed an app that has these restrictions, you will see an error after pasting the link or code into the content box.

    It is still possible to connect these apps as Partner Apps using the Connect as link setting. Instead of embedding directly into the portal, the connected content will open in a new browser tab. The Partner App will appear as a regular item in the client's sidebar, but the link will open in a new tab when the client clicks on the app.

    **Unsupported Embeds** Some apps that offer external embeds cannot be supported by Assembly because the embed code contains JavaScript or other unsupported HTML tags. This is seen most commonly in widgets or other interactive embeds.
  </Accordion>
</AccordionGroup>