> ## Documentation Index
> Fetch the complete documentation index at: https://moengage-analytics-query-api-docs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Add Forms to your In-app Campaign

> Add interactive forms to MoEngage in-app campaigns for lead generation, feedback collection, and user surveys using the drag and drop editor.

## Overview

Use forms in your MoEngage In-App campaigns to make them interactive. Forms help you engage users and encourage participation, which can generate leads, gather feedback, and conduct surveys. This improves the effectiveness of your app and benefits your business.

<Info>
  You can create forms only with the **Drag and drop** editor.
</Info>

## Add Forms to Your In-App Campaign

<Tip>
  Ensure that you're present in Step 2 of creating content for your In-app campaign. For more information, refer to [Create In-App Campaign](/user-guide/campaigns-and-channels/in-app-message/create/create-in-app-campaign).
</Tip>

To configure a form for your In-App campaign, follow these steps:

1. On the **Content** page, select one of the pre-built **Drag and drop** form templates, or create one from scratch. In this article, you will create a new registration form from scratch. Click the **Start with a blank canvas** button.

   <img alt="new form template.gif" src="https://mintcdn.com/moengage-analytics-query-api-docs/xrD9ZIyo3w8qN3oF/images/moengage_012e41.png?s=8afacf47c14256c5b9d59f0f62842a0f" width="2612" height="1088" data-path="images/moengage_012e41.png" />

   <Info>
     Your dashboard includes the following pre-built form templates:

     <img alt="prebuilt templates.png" src="https://mintcdn.com/moengage-analytics-query-api-docs/U3b_LbDL6ZrBKo8L/images/moengage_bfdb21.png?fit=max&auto=format&n=U3b_LbDL6ZrBKo8L&q=85&s=bb490ffb571d3dbdb9e3d2093b3aa031" width="1186" height="648" data-path="images/moengage_bfdb21.png" />
   </Info>
2. Drag the **Form** element to the desired position in the template. Then, click **Edit Form**.
   <img alt="drag form new.gif" src="https://mintcdn.com/moengage-analytics-query-api-docs/9jVqMiqVuIFdIMJ4/images/moengage_0cad44.png?s=558a1ba8956e5416865ca8a52009ee30" width="2528" height="1224" data-path="images/moengage_0cad44.png" />
3. In the **Create form** pop-up, enter the following details:
   * **Label**: A user-friendly name to identify form fields.
   * **Input type**: Select one of the following input types:
     * **Email**: A valid email address.
     * **Text Checkbox**: Allows users to select multiple options from a list.
     * **Date**: Allows users to select a date from a calendar or enter a date in DD/MM/YYYY format.
     * **Label**: Guides users on the value to enter in the associated input field.
     * **Number**: Accepts numerical values, such as a phone number or age.
     * **Radio**: Allows users to select a single option from a set.
     * **Dropdown**: Presents a list of options for users to choose from.
     * **Telephone**: Accepts a user's phone number.
     * **DateTime**: Allows users to enter both date and time for bookings or appointments.
   * **Placeholder text**: A short text to help users enter the correct data in the input field.
   * **Required**: Select this option to make the field mandatory before the user can continue or submit the form.
   * **User property**: Select a user attribute to update with the value that users enter in the form. The user property updates only after users submit the form.<img alt="enter form details.gif" src="https://mintcdn.com/moengage-analytics-query-api-docs/xqg7J9GuW1XHY7Tk/images/moengage_9b9c2c.png?s=1a23a4097b37c8de5197e0d39155399c" width="2224" height="1088" data-path="images/moengage_9b9c2c.png" />
   <Info>
     The **Submit** button is enabled by default. You can change only its name.
   </Info>
4. Click **Done** to confirm your form elements.
5. Configure the appearance of the form elements in the **Content Properties** section.
   <img alt="form format.png" src="https://mintcdn.com/moengage-analytics-query-api-docs/B1dP3oCRPo4NMx7b/images/moengage_fb99c2.png?fit=max&auto=format&n=B1dP3oCRPo4NMx7b&q=85&s=ab1f8c04dc7db9599efa06dded11f4f3" width="800" height="2672" data-path="images/moengage_fb99c2.png" />
6. Click **Next** to complete the campaign creation.

## View Submitted Form Responses

After you publish a campaign that includes a form, you can monitor and analyze the submitted responses. Go to the **Form Inputs** section in your dashboard for detailed information about the responses.

1. From the left navigation menu in the MoEngage UI, click **Engage** > **Campaigns**.
2. From the **All Campaigns** page, select the campaign that includes the form.
   <img alt="choose campaign.gif" src="https://mintcdn.com/moengage-analytics-query-api-docs/8GscUheGMO8Wf0AE/images/moengage_308207.png?s=bb2de4eb9a9c0b62e6a950a44c44ed04" width="1920" height="850" data-path="images/moengage_308207.png" />
3. Use the high-level filters, such as **Date Range**, **Attribution Type**, and **Platform**, to refine the campaign data. For more information, refer to [Analyze In-App Campaign](/user-guide/campaigns-and-channels/in-app-message/analyze/analyze-in-app-campaigns).
   <img alt="global filters.png" src="https://mintcdn.com/moengage-analytics-query-api-docs/Y31ab75R1bS4e0sI/images/moengage_c3249a.png?fit=max&auto=format&n=Y31ab75R1bS4e0sI&q=85&s=bdf6a9f4500a962bdcab1bfe858b7977" width="2638" height="332" data-path="images/moengage_c3249a.png" />
4. Scroll down to the **Form Inputs** section on the **Analytics** page.
   <img alt="scroll to form inputs.gif" src="https://mintcdn.com/moengage-analytics-query-api-docs/MeUdCPw1UK4cXHEf/images/moengage_cbfeb4.png?s=0cdf4988e25d4cf77d0f0ac37d9c1992" width="1920" height="850" data-path="images/moengage_cbfeb4.png" />
   <Info>
     * The **Form Inputs** section appears only after your campaign begins to engage users.
     * Data appears in the **Form Inputs** section only after a user submits the form. For example, the **Form Inputs** section shows "Not applicable" if users complete the form but do not submit it.
   </Info>
5. You can view the following details:
   * **Locales**: The locale is set to default, but you can change it from the drop-down list.
   * **Variations**: Select the specific variation from the drop-down list to view its metrics.
   * **Total Rows**: Shows the total number of users who submitted a response. You can filter these users by:
     * **User ID**
     * **Name**
     * **Email**\
       **<img alt="form input filter attributes.png" src="https://mintcdn.com/moengage-analytics-query-api-docs/wmiIN-H-PtSrzLh0/images/moengage_79dccc.png?fit=max&auto=format&n=wmiIN-H-PtSrzLh0&q=85&s=eb0d3b1dfec8e44a16cf37eaf1ecfb36" width="348" height="384" data-path="images/moengage_79dccc.png" />**

       The response for each user attribute appears in the adjacent column. For example, if you select **User ID** from the list, the analytics page displays the user ID "x1z2y3" and their corresponding response "[xyz@gmail.com](mailto:xyz@gmail.com)". If you select **Name** or **Email**, the analytics displays the name or email of the users and their responses.

       <Info>
         * Responses for both iOS and Android appear together. You cannot filter responses by platform. To view separate data, ensure you track different attributes for iOS and Android.
         * The **Form Inputs** table displays a maximum of seven responses.\
           To view all responses, follow these steps:
           1. Go to your MoEngage dashboard, then click **Segment** > **Create segment**.
           2. In the **Filter users by** tab, select **User behavior**, and add the **Has Executed** event as **Response Submitted**.
           3. Specify the event's time range and campaign ID to get a more precise count of users who submitted a response to the campaign.
           4. Click **Show count** to analyze the result.
           5. Under **Query Results**, you will see the number of users who submitted a response to the campaign.
       </Info>
6. You can also download the CSV file that contains the user responses.
   <img alt="download csv file form inputs.gif" src="https://mintcdn.com/moengage-analytics-query-api-docs/FeDOaUaZp6fDSte_/images/moengage_80e55c.png?s=62b4c97071c3428d4e7b2b96d6238859" width="1920" height="697" data-path="images/moengage_80e55c.png" />
   <Warning>
     You can select a maximum of 10 attributes to export. Use **Date Range**, **Locale**, and **Variation** filters for more specific data.
   </Warning>

## Frequently Asked Questions

<Accordion title="Can I create a multi-page form?">
  You can create only a single form per campaign. Multi-page forms are not supported.
</Accordion>

<Accordion title="How do I customize the close button?">
  You can upload a custom image for the close button. Then, add the *close-btn* class, as shown in the following screenshot:

  <img alt="Screenshot 2024-09-11 at 12.25.39 PM.png" src="https://mintcdn.com/moengage-analytics-query-api-docs/hxK-zIlFnolb1ilr/images/moengage_81d31f.png?fit=max&auto=format&n=hxK-zIlFnolb1ilr&q=85&s=d8642f6c4edfef954b37543b6c45f36b" width="393" height="180" data-path="images/moengage_81d31f.png" />
</Accordion>

<Accordion title="How many form elements can I add to a screen?">
  We recommend that you add only one form per campaign.
</Accordion>

<Accordion title="How many inputs can I add to a form?">
  You can add as many inputs as you want. Scroll down the pop-up to access them.
</Accordion>
