Getting started with admin link extensions

• You've created a Partner account and a development store.
• You understand how apps fit into Shopify and the different ways of distributing your app.
• You've created an app.

When you add an admin link for your app, the link displays in the More actions menu on the Shopify admin pages that you specify. Users can then access your app to complete a task directly.

1. Log in to your Partner Dashboard.
2. Click Apps.
3. Click the name of the app that you want to create links for.
4. Click Extensions.
5. Click Create +.
6. Under Shopify admin, click the Admin links card.

7. Enter information in the following fields:

   • Extension Name: The name of your extension. This name is used to manage your extension internally. It won't display to users.
   • Link label: The text that displays to the user. The label should be task-oriented, and not just the name of your app.
   • Link target URL: The URL where your app is hosted.
   • Page to show link: The page where this link should display to the user. Try to place the link only where it makes logical sense for the user. In general, avoid adding admin links to every page of the Shopify admin.

8. Click Create.

   The admin link is deployed to your production app and is immediately available to users that have installed your app on their store.

9. Optional: To add more admin links, click Create + and repeat the relevant steps in this procedure.

The following are examples that you can references to better understand how and when to use admin links:

The Order Printer app uses an admin link on order pages to let users print invoices:

The Digital Downloads app uses an admin link on product pages to let users add digital attachments:

You can track incoming admin links with parameters that identify the store or resource where your app is used. For example, each admin link includes a URL parameter that contains the store URL. This URL identifies the unique store or resource that's using your app.

Example: https://my-app-link-target.com/example?shop=johns-apparel.myshopify.com.

When your admin link is on a detail page, such as the Order Details page, the link also includes a URL parameter that contains the unique resource ID for the item on that page:

Example: ?id=3295398979&shop=johns-apparel.myshopify.com

You can make your apps accessible to users wherever action drop-down lists are available in the Shopify admin.

1. From the Partner Dashboard, click Apps.
2. Click the name of the app that you want to create links for.
3. Click Extensions.
4. Click Create +.
5. Under Shopify admin, click the Bulk action links card.

6. Enter information in the following fields:

   • Extension Name: The name of your extension. This name is used to manage your extension internally. It won't display to users.
   • Link label: The text that displays to the user. The label should be task-oriented, and not just the name of your app.
   • Link target URL: The URL where your app is hosted.
   • Page to show link: The page of the where the More actions drop-down list should display. Try to place the link only where it makes logical sense for the user. In general, avoid adding admin links to every page of the Shopify admin.

7. Click Create.

   The bulk action link is deployed to your production app and is immediately available to users that have installed your app on their store.

8. Optional: To add more bulk action links, click Create + and repeat the relevant steps in this procedure.

When a user selects multiple orders on the Orders page of the Shopify admin, the Actions drop-down menu displays. You can use the Actions menu to prompt users to use your app when they complete a bulk action:

You can add navigation links to display your app's navigation items consistently across devices.

1. From the Partner Dashboard, click Apps.
2. Click the name of the app you want to create links for.
3. Click Configuration.
4. In the App settings section, in the Embedded app home card, click Manage navigation.
5. From the Navigation bar page, click Add navigation link.

6. Enter information in the following fields, and click Add link:

   • Name: Enter a title for the menu item. This title will be displayed to users.
   • Link: Enter your subpage URL. The URL must be from the same source as your app.

   The menu item is added to your list.

7. Optional: To add more navigation links, click Add navigation link, and repeat step 7.

8. Optional: To upload a navigation icon, click Upload icon.

9. Optional: To reorganize your navigation menu item’s order, drag each item to your desired order, or use the arrow buttons.

10. Optional: To remove a navigation link, click the trash can icon.

11. Click Save.

    The navigation configuration is deployed to your production app and is immediately available to merchants that have installed your app on their store.

• Learn about admin action and block extensions, which enable your app to create workflows and UX that users can access directly on the page.