Blocked legacy app migration - UNLISTED_APP_OVER_PRIVATE_INSTALL_LIMIT

Hi,

I am trying to migrate one of our legacy public apps to 2026.03. When I run hs app migrate, the app I want to migrate shows the following:

Unable to migrate app:
UNLISTED_APP_OVER_PRIVATE_INSTALL_LIMIT

This is a staging/testing app so we can’t list it on the marketplace, so is there anything else I can do to be able to migrate it?

Thanks!

Hey @carman_li, It looks like you’ve hit the private install limit for an unlisted public app.
Since this is a staging app, I’d first check how many portals currently have the app installed. The UNLISTED_APP_OVER_PRIVATE_INSTALL_LIMIT error typically indicates the app has exceeded the allowed private install threshold for an unlisted public app.

If that’s the case, try uninstalling it from any unused test portals and rerun hs app migrate. If you have multiple staging apps, it may also be worth migrating the one with fewer installs or creating a fresh staging app if that’s a viable option for your workflow.

If the error persists even after reducing installs, it may be worth checking whether the limit is being calculated correctly for your app.

Hope this helps!

Hi Alex, thanks for your reply! I’ve uninstalled as many test portals as I have access to, but I’m still running into the error. Unfortunately, there’s no way for me to see how many installs the app is currently at, but I am curious to know what the calculated limit is for my app.

How would I check whether the limit is being calculated correctly/what the current install count is for the app?

Hey @carman_li,

Thanks so much for providing this follow-up context! Re-tagging @Alex_Boissonneault for visibility.

Shane, Senior Community Moderator

@carman_li
Hi Carman, how is it going?
Did you resolve your problem? If you did it successfully, how did you do that? Could you share your way to overpass this issue?

@son.nguyen.developer

Hi, I was able to resolve the issue by opening a support ticket, they were able to bulk uninstall the app for all connected portals.

Thank you very much Carman_li, I’ll open a support ticket