Unable to Update Mini Handle — generateUserToken Fails After Changing Handle

Hi team,

During early testing, I created my Shop Mini using a temporary handle: test-shop-mini-dev.

I am now preparing the Mini for submission. However, when the permission confirmation modal appears, it shows:

“test-shop-mini-dev is requesting camera access”

Since this handle is not suitable for production, I tried updating the handle in my manifest.json.

After updating the handle, the useGenerateUserToken hook starts throwing an error indicating that the Mini not found.

Issue:
I need to update the Mini handle for submission, but after changing it, Shopify reports that the Mini cannot be found when generating the token.

Request:
Could you please guide me on the correct way to change the Mini handle so that the Mini continues to function and generateUserToken succeeds?

Thank you!

Hi @abhishek.chaudhary ,

When you update the handle in your manifest.json, you should also delete your Minis api key from .env and run npx shop-minis setup from scratch, which will create a new Mini for you, and store a new API key. Token verification flow should work as expected after creating a new Mini. (make sure you update the api key on your backend for verification as well)

Hi @Tunca-Shopify , thanks for the suggestion. I tried the exact steps you shared.
First, I updated the handle in manifest.json.
Then, I deleted the SHOP_MINIS_API_KEY from .env file
Then I ran npx shop-minis setup in the terminal, and here, one error is coming. Error is mentioned below:

This is where I am getting blocked and not able to update the handle and generate a new key.
Please guide me here.

Thanks

@abhishek.chaudhary Can you delete the handle from manifest.json and remove the api key from .env? A new handle will be created based on your Mini name when you run npx shop-minis setup. We plan to add a new command to simplify handle updates in the future, but it’s a bit manual at the moment.

Hi @Tunca-Shopify , yes it worked, thanks a lot!