web
You’re offline. This is a read only version of the page.
close
Skip to main content

Announcements

News and Announcements icon
Community site session details

Community site session details

Session Id :
Power Platform Community / Forums / Power Apps / Urgent: ErrOpeningDocu...
Power Apps
Suggested Answer

Urgent: ErrOpeningDocument_UnknownError - Canvas App locked, cannot open or restore

(0) ShareShare
ReportReport
Posted on by 7
Hi Community,

We are facing a critical issue with our Power Apps canvas app that
has been blocked since yesterday night after a browser refresh
during an active editing session.

ENVIRONMENT:
- App Name: User
- App Type: Canvas App
- Issue started: After browser refresh during editing session

ERROR 1 - When opening app:
ErrOpeningDocument_UnknownError
"There was an error opening the file"

ERROR 2 - When restoring previous version:
"Restore failed. 'User' is locked by user with object id. If all authoring sessions
for this app have recently been closed, please wait at least 15
minutes before retrying the operation."

WHAT WE HAVE TRIED:
✖ Waited 2+ hours
✖ Signed out and signed back in
✖ Cleared browser cache and cookies
✖ Tried different browsers
✖ Tried restoring previous version — fails with lock error

WHAT WE NEED:
1. How to force-clear the session lock without Microsoft support
2. Any alternative way to recover/restore the app

Please help — this is blocking our entire project.
Thanks in advance!

#powerapps #canvas-app #error #restore #locked #urgent
Screenshot 2026-04-07 113643.png
Categories:
I have the same question (0)
  • Suggested answer
    Sunil Kumar Pashikanti Profile Picture
    1,872 Moderator on at
     
    What is actually happening (simple explanation)
    • Power Apps uses exclusive edit locks
    • A browser refresh can leave the app marked as “in use”
    • The lock fails to auto‑expire (even after hours)
    • Restore, Edit, and SaveAs all fail because the backend believes the app is still open
    This exact pattern is confirmed in multiple community threads and Stack Overflow posts
     
     
    What works (Actionable Recovery Options – in order)
    Option 1 – Tenant Admin: Force sign‑out the locked user (MOST SUCCESSFUL)
    If you have M365 / Entra admin access:
    • Go to Microsoft Entra Admin Center
    • Find the affected user
    • Sign out of all sessions
    • Wait 10–15 minutes
    • Retry opening or restoring the app
    Option 2 – Export the app (if possible)
    If the app still:
    • Appears in Maker Portal
    • Allows Export Package (.zip)
    Then:
    • Export it
    • Import into same or new environment
    • Continue work on the imported copy
    This fails if the lock blocks export entirely.
     
    Option 3 – Power Platform Admin PowerShell (Admin‑only)
    If you are Environment or Global Admin:
    PowerShell
    Install-Module Microsoft.PowerApps.Administration.PowerShell
    Add-PowerAppsAccount
    Unlock-AdminPowerApp -AppName "<AppID>" -EnvironmentName "<EnvID>"
     
    This can clear backend locks
    Requires elevated admin permissions
     
    Let us know if it helps!
     
  • CarlosFigueira Profile Picture
    Microsoft Employee on at
    @CU07040603-0 can you please share a session id of when you get the error opening the app?
  • CU07040603-0 Profile Picture
    7 on at
    @Sunil Kumar Pashikanti

    Thanks for the inputs, I have asked the Tenant Admin to cross check on it
  • CU07040603-0 Profile Picture
    7 on at
    @CarlosFigueira

    Session ID: 8c64a5c2-acc3-4be2-af6b-4e7fdbd0034d - This is the session ID
  • smanesis Profile Picture
    17 on at
    Hello,
     
    I'm currently having the same issue. I followed the steps that @Sunil Kumar Pashikanti wrote but the cmdlet: Unlock-AdminPowerApp does not exist.

    Any other suggestions?
     
    Thank you in advance
  • Power Platform Guy Profile Picture
    134 on at
     

    Go to the Power Apps Maker Portal (https://make.powerapps.com). Navigate to Apps > Details of the app. Check if the app is in a "Checked Out" or locked state.

    If it's locked: Attempt to Check In the app from the app details page.

    Force Unlock Using PowerShell

    Install-Module -Name Microsoft.PowerApps.Administration.PowerShell
    Install-Module -Name Microsoft.PowerApps.PowerShell -AllowClobber

    Add-PowerAppsAccount
    Get-AdminPowerApp -EnvironmentName <EnvironmentName>

    Unlock-AdminPowerApp -AppName "<AppName>" -EnvironmentName "<EnvironmentName>"

    ☑️Accept as Solution to help others 💙 A Like is appreciated ❓Tag @PowerPlatform Guy for any queries

  • Suggested answer
    11manish Profile Picture
    1,537 on at
    This issue is caused by a stale authoring session lock due to an interrupted editing session.
     
    There is no direct way to force-clear the lock without backend intervention, but you can recover the app by trying alternative access paths such as exporting the app, restoring from the Versions tab, or opening in play mode and saving a copy.
     
    If these do not work, the lock usually clears after backend session expiration, or requires Microsoft support to manually release it.
  • Sunil Kumar Pashikanti Profile Picture
    1,872 Moderator on at
     
    That cmdletUnlock-AdminPowerApp does not exist in the GA (General Availability) Microsoft.PowerApps.Administration.PowerShell module. It was likely a preview-only discussion that never made it to the final build.
     
    Can you try this Solution: Three Paths to Recovery
    If your app is locked or refusing to open, follow these steps in order:
    1. Verify Your Environment
    Ensure you are running the correct module. Many issues stem from outdated versions.
    PowerShell
    # Force an update to the latest admin module
          Install-Module Microsoft.PowerApps.Administration.PowerShell -Force
          Import-Module Microsoft.PowerApps.Administration.PowerShell
    # Verify available cmdlets
          Get-Command *AdminPowerApp*

    2. Force-Take Ownership (The "Soft Unlock")
    Often, the "lock" is actually a metadata mismatch or a reference to a deleted user. Re-assigning ownership forces a refresh of the app's backend record.
    PowerShell
    Set-AdminPowerAppOwner `
      -AppName <AppId> `
      -EnvironmentName <EnvironmentId> `
      -AppOwner <your-admin-UPN>

    3. Bypass the Editor via Admin Copy
    If the Studio editor is the part that's failing, you can often bypass it entirely by creating a fresh copy of the app via the API.
    PowerShell
    Copy-AdminPowerApp `
      -SourceAppName <AppId> `
      -TargetAppName "Recovered_App_Backup" `
      -SourceEnvironmentName <EnvId> `
      -TargetEnvironmentName <EnvId>

    When to Open a Support Ticket
    If Copy-AdminPowerApp fails, you are likely dealing with deep backend corruption (e.g., a truncated .msapp file in the blob storage).
    Don't delete the app. Open a ticket and explicitly mention:
     
    "Attempted Set-AdminPowerAppOwner and Copy-AdminPowerApp without success. App fails with ErrOpeningDocument_UnknownError.
    Requesting backend rehydration or a roll-back to an internal snapshot."
     

Under review

Thank you for your reply! To ensure a great experience for everyone, your content is awaiting approval by our Community Managers. Please check back later.

Helpful resources

Quick Links

Introducing the 2026 Season 1 community Super Users

Congratulations to our 2026 Super Users!

Kudos to our 2025 Community Spotlight Honorees

Congratulations to our 2025 community superstars!

Congratulations to the March Top 10 Community Leaders!

These are the community rock stars!

Leaderboard > Power Apps

#1
11manish Profile Picture

11manish 516

#2
WarrenBelz Profile Picture

WarrenBelz 450 Most Valuable Professional

#3
Vish WR Profile Picture

Vish WR 448

Last 30 days Overall leaderboard