How can I set up universal links for iOS and Android?

Universal links on iOS and App Links on Android connect your Shopify store's custom domain to your mobile app. When a customer opens a link such as yourstore.com, it automatically opens your app if it is installed, or your online store if it is not.

For example, if a user receives an email with a link to https://shop.com/products/dress, tapping the link opens the product inside the app when the app is installed. If the app is not installed, the same link opens normally in the user's web browser.

Deep links also work for collections and other compatible store pages, opening the corresponding content directly in the app when it is installed.

Prerequisites

  • Your Shopify store must use a custom domain. A *.myshopify.com domain cannot be used for this setup.
  • Contact Makappi support and ask for the following information:
    • iOS: Apple App ID
    • Android: Application ID and SHA-256 signing certificate fingerprint

Set up the custom app in Shopify

1. Open app development settings

In your Shopify admin, go to Settings > Apps and sales channels > Develop apps.

Develop apps page in Shopify admin

2. Allow legacy custom app development if required

If Shopify displays the option, select Allow legacy custom app development. If you do not see this message, create an app directly and continue at step 5.

Allow legacy custom app development option

3. Confirm custom app development

Select Allow custom app development.

Allow custom app development confirmation

4. Create a legacy custom app

Select Create a legacy custom app.

Create a legacy custom app button

5. Name and create the app

Enter Makappi as the app name, then select Create app.

Creating the Makappi custom app

6. Configure the Storefront API scopes

Select Configure Storefront API scopes.

Configure Storefront API scopes button

7. Grant product listing access

Select unauthenticated_read_product_listings from the permissions list, then select Save.

Storefront API product listing permission

8. Install the app

After saving the permission, select Install app.

Install app button in Shopify

9. Confirm the installation

Select Install in the confirmation popup.

Shopify app installation confirmation

Configure iOS and Android

10. Edit the Storefront API integration

Open the Configuration tab, then select Edit in the Storefront API integration section.

Edit Storefront API integration button

11. Enter the iOS and Android identifiers

Scroll down to the iOS and Android sections, then enter the information provided by Makappi support:

  • iOS: enter the Apple App ID and select both Use iOS universal links and Use iOS web credentials.
  • Android: enter the Android Application ID and the SHA-256 signing certificate fingerprint.
iOS and Android universal link identifiers in Shopify

12. Save the configuration

Scroll back to the top of the page and select Save.

Save Storefront API integration configuration
Back to FAQ