Why am I getting an error when installing the Instant App to Shopify?

As of 1 January 2026, Shopify updated how apps are installed and connected to stores. Instant now uses this new connection method, so you may see different steps than you’re used to.

To continue, follow the on-screen instructions in Instant that is shown during onboarding. 
If you’d prefer a detailed guided walkthrough, and to follow along with a tutorial, you can also watch the video below.

Most common cause of errors

In almost all cases, an install fails because Shopify didn’t grant all the permissions Instant needs. When Shopify asks you to select scopes, copy and paste this full list:

write_themes,read_themes,write_script_tags,read_script_tags,write_customers,read_customers,read_products,read_orders,read_customer_events,write_discounts,read_discounts,write_content,read_content,read_inventory,write_online_store_pages,read_online_store_pages,write_pixels,read_pixels,unauthenticated_write_checkouts,unauthenticated_read_checkouts,unauthenticated_read_customers,unauthenticated_read_product_listings

When your connection is successful, you'll receive a green success message. If you're missing any permissions still, they will list on screen and you can easily add any missing permissions