Add a custom page to your model-driven app

This article guides you through creating and editing a custom page for a model-driven app using the modern app designer.

Important

Custom pages are a new feature with significant product changes and currently have a number of known limitations outlined in Custom Page Known Issues.

This article walks you through opening a model-driven apps in the app designer, which you use to add a custom page to a model-driven app. If you need to create a new model-driven app, go to Create a model-driven app with the app designer.

Create or edit a custom page

Custom pages can be created from two places. The first is while authoring a model-driven app in the modern app designer. The other is from the Solutions area in Power Apps. Custom pages can be edited from the Solutions area but won't appear in the Home or Apps areas of make.powerapps.com.

Note

Custom pages must be created from a solution either from the modern app designer and or the Solutions area in Power Apps using New > App > Page. The custom page is a different canvas app type than the normal standalone canvas app.

Create new custom page from modern app designer

  1. Open make.powerapps.com

  2. On the left navigation pane, select Solutions. If the item isn’t in the side panel pane, select …More and then select the item you want.

  3. Open the solution containing the existing model-driven app.

  4. Select the model-driven app where you want to add a custom page, and then select Edit on the command bar.

  5. In the app designer, select Add page > Custom page on the command bar.

  6. Select Create custom page.

    New page select custom page

  7. The canvas app designer opens for page authoring.

    Canvas designer new page

  8. When you're finished creating your canvas app custom page, Save, Publish, and then close the canvas app designer browser tab to return to the model-driven app designer.

Create new custom page from the solutions area

  1. Sign in to Power Apps

  2. Select Solutions from the left navigation pane. If the item isn’t in the side panel pane, select …More and then select the item you want.

  3. Open or create a solution to contain the new custom page

  4. Select New > App > Page.

    Solutions area create new page

Edit an existing custom page

  1. Open up make.powerapps.com

  2. Select Solutions from the left navigation pane. If the item isn’t in the side panel pane, select …More and then select the item you want.

  3. Open or create a solution to contain the new custom page.

  4. Select the custom page with Page type, and then select Edit.

    Solutions area new page

Author custom page content

  1. Design the custom page content. More information: Design a custom page for your model-driven app

  2. Save and publish the custom page.

  3. Close canvas app designer.

  4. Return to the app designer browser tab and refresh the app designer by selecting Dismiss.

    Dismiss creating your page prompt

  5. Select Publish in the app designer to add the changed custom page into the model-driven app.

  6. Select Preview to play the app in a new browser tab.

Add an existing custom page into a site map

  1. Sign into make.powerapps.com

  2. Open an existing model-driven app using modern app designer.

  3. Select the Add page > Custom page on the command bar.

  4. Select the custom page in the list of custom pages available in the environment, and then select Add.

    Select and existing custom page to add to the app

  5. Select Publish, which also saves the app if there are changes.

  6. Select Play to run the app in a new browser tab.

  7. To close the app designer select Back and return to the solution.

Publishing a custom page

Important

Currently, model-driven apps must be re-published after a custom page is published. Otherwise the model-driven app continues to use the previous published custom page.

After saving changes to a custom page in the canvas designer, the custom page must be first published by the canvas designer. Then all model-driven apps referencing that custom page need to be published.

  1. From canvas designer, select Publish

  2. From app designer or solution explorer, select Publish on each model-driven app referencing the custom page

See also

Model-driven app custom page overview

Design a custom page for your model-driven app

Using PowerFx in custom page

Navigating to a custom page using client API

Code components for custom page designer