Troubleshoot common issues when using the wrap feature

This guide provides solutions to common issues you might encounter when using the wrap feature in Microsoft Power Apps.

Issue 1: Wrap build fails

If your wrap build fails, try the following actions:

Verify image formats

Ensure that all images in your wrap project are in PNG format. Using other formats can cause the build to fail. Use an image converter to convert your images to .png format.

Check Azure key vault setup

• Ensure you create an Azure service principal and assign the correct role.
• For more information, see Azure key vault for wrap in Power Apps.

Your key vault must contain:

• For iOS: two tags, one certificate, and one secret.
• For Android: one tag and one certificate.

Issue 2: Wrap button is disabled

Confirm you have edit permissions for the app and try again. For a list of requirements, see Permissions and access requirements for wrap.

Issue 3: Unable to save your wrap project or trigger a build

Update to the latest version of the wrap solution and try again.

Issue 4: Unable to install a wrapped mobile app

Ensure your app is properly signed by configuring a key vault during the build process or by signing the app manually.

For more information, see:

• Set up Key vault for automated signing
• Code sign for iOS
• Code sign for Android

Additionally, verify your device meets the minimum requirements.

Issue 5: Can't sign in or see data in a wrapped app

If you can't sign in or see data in your wrapped app, try the following actions:

Verify API permissions and access

• Ensure all required API permissions are configured and that admin permissions are granted.

  

• Ensure the Add-AdminAllowedThirdPartyApps script runs successfully.
  For more information, see Allow registered apps in your environment.

Check account types and redirect URIs

• Verify the Microsoft Entra app type is set to Multitenant and that the supported account type is Accounts in any organizational directory (Any Microsoft Entra ID tenant).

• Configure proper redirect URIs for iOS and Android:

  • For Android, confirm the hash is correct.
  • For more information, see Configure platform settings and redirect URIs.

Issue 6: Fail to sign in to a wrapped app

1. Ensure the user has access to the app. For more information, see Share a canvas app with your organization.

2. If the user has app access but still can't sign in, check the Conditional Access policies in the Microsoft Entra admin center.

3. To troubleshoot sign-in errors, copy the correlation ID from the mobile screen where the sign-in failed and refer to How to troubleshoot Microsoft Entra sign-in errors to understand the error and the failed policies.

4. Check Microsoft Entra authentication and authorization error codes.

Other issues

If your issue isn't covered here, or if the preceding steps don't resolve your problem, search for more support resources or contact Microsoft support with detailed steps to reproduce the problem.

Collect diagnostic information

For sign-in issues, you can collect session details and include them when you contact Microsoft support:

• For the wrap wizard: On the sign-in screen, tap the gear icon in the upper-right corner and select Session Details.
• For mobile devices: After opening the app, press and hold the screen, and then select Session Details.