Add form


Effective October 12, 2022, Power Apps portals is Power Pages. More information: Microsoft Power Pages is now generally available (blog)
We will soon migrate and merge the Power Apps portals documentation with Power Pages documentation.

Form is a data-driven configuration that collects data in the portal without the need for a developer to surface the form in the portal.

Forms are created in Microsoft Dataverse. You can use them in webpages in the portal or in conjunction with lists to build out complete web applications.

To add a form component:

  1. Edit the portal to open it in Power Apps portals Studio.

  2. Select the page on which you want to add the component.

  3. Select an editable element on the canvas.

  4. Select Components components icon. from the left side of the screen.

  5. Under Portal components, select Form.

  6. In the properties pane on the right side of the screen, select one of the following options:

    • Create new: Create a new form.
    • Use existing: Use an existing form.
  7. Enter information or make selection:

    • Name: Name of the form.

    • Table: The name of the table from which the form is loaded.

    • Form layout: The name of the form on the target table in Dataverse that is to be rendered.

    • Mode: Select one of the following options:

      • Insert: Indicates the form should insert a new record upon submission.

      • Edit: Indicates the form should edit an existing record.

      • Read only: Indicates the form should display an existing record's non-editable form.


      The default option for Edit and ReadOnly modes is set as Query String Parameter Name passed as ID in URL. To change these values, you need to open Portal Management app and update the form properties.

    • On success: Select one of the following options:

      • Show success message: Requires a message to be displayed to the user on successful submission of the form. You can also select Hide form on success to hide the form upon successful submission.

      • Redirect to webpage: Redirects the user to the selected webpage in the portal. This field is required.

      • Redirect to URL: Redirects the user to the specified URL. This field is required.

    • Show captcha for anonymous users: Displays captcha to anonymous users.

    • Show captcha for authenticated users: Displays captcha to authenticated users.

    • Permissions: Table permissions to be considered for the form. Configure table permissions to make the form available to anyone, or any specific roles.

      Form properties.


    By default, permissions are applied to components containing data. Making it visible to anyone, or only to specific roles, is done by managing table permissions.

See also