> ## 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.

# Jotform embed

> Embed a Jotform directly within your portal.

Assembly enables you to embed a Jotform directly within your portal. "Jotform features form design, where users can design customized forms using a" drag-and-drop interface.

## App setup

1. Go to **App Library**, and click **+ Add an app** in the top right corner.
2. Select **Jotform** 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, and configure whether all clients can see it or only a subset.
5. The documentation recommends setting this up as an **automatic** app so that your Jotform will be visible to all clients. If you only want this app to be visible to one or more specific clients, set this as a **manual** app.
6. Leave the app set to **Show as embed** so that the client isn't directed outside of the portal.
7. Next, go to your **My Forms** page in Jotform.
8. To share a Form, click the drop-down menu for the desired form and click **Publish Form**.
9. Click **Embed** in the top menu and then in the right dropdown, select **iframe**.
10. Click the **Copy Code** button.
11. Go back to the **App Setup** page and paste the iframe code into the content box.
12. Click **Add** to be redirected to the app.

### Additional configuration

With this app, the **Copy link** method has a scrolling error. "We recommend only using the iframe code provided by Jotform."

Occasionally the code provided by Jotform will not fill the full screen due to the settings provided in the Jotform iframe code. To fix this issue, you'll want to do the following:

1. Near the top of the iframe code there's a line that says:

   `style="min-width:100%;max-width:100%;height:539px;border:none;"`

2. Update the height in that style to be 100%:

   `style="min-width:100%;max-width:100%;height:100%;border:none;"`

To preview the app as a client, click **Portal** at the bottom of the sidebar and click **Open portal**. Once you're logged in as your test client you'll be able to view the connected app.

### URL parameters

You can pre-fill your Jotform using your client or company data and custom fields using URL parameters. Consult the article on URL parameters for configuration instructions.

In Jotform, if you click on a field in your form while in the **Build** section, you should see a gear icon where you can modify the settings for the field.

Under **Advanced > Field details**, you'll see the **Unique name** for the field. This is the name you will want to enter in the URL parameter input when setting up the app in Assembly. Then, select the related property from the dropdown that appears when clicking the related Property input.
