DocumentationAPI referenceSupportPrivate beta
MigrateTo
Try free

Deploy to Power Pages

Take the package you downloaded and put it live in your Power Pages environment.

Prerequisites

  • A Power Pages environment URL (for example https://contoso.powerappsportals.com).
  • The Power Platform CLI installed (pac) — install instructions.
  • A user (or service principal) with the System Administrator or Power Pages Administrator role.

Manual upload

# 1. authenticate to your environment
pac auth create --environment https://contoso.crm.dynamics.com

# 2. upload the package
pac paportal upload --path ./portal-package

# 3. (optional) clear server cache so changes are visible immediately
pac paportal upload --path ./portal-package --modelVersion 2 --deploymentProfile prod

Automated via Azure DevOps

  1. Open the reference pipeline at pipelines/azure-devops.yml inside the package.
  2. Create a Power Platform service connection in your Azure DevOps project.
  3. Set variables: PowerPlatformServiceConnection, EnvironmentUrl, PortalPath.
  4. Commit the YAML to your repository and run.
Test in a non-prod environment first
Power Pages uploads can replace existing web templates, page templates, and basic forms by name. Always upload to a dev / test environment before promoting to production.

Verify the deploy

  1. Browse to your portal URL.
  2. Open Portal Management in the Maker portal and check Web Templates and Page Templates show the new names.
  3. Hit a page bound to Dataverse and confirm the FetchXML query returned rows.

Rollback

The package is just files. Keep the previous ZIP and re-upload it to revert. We recommend committing every downloaded package to git so you have a deploy history.

Was this page helpful?Send feedback →