Purpose

Start in Optiply to see which connection route your account offers; then create a Shopify app only when that route calls for one.

Use your integration settings to link the intended Shopify store to Optiply. For a connection that needs your own app, create a released version and install it. Then check the connected source list and review the import job; a Connected label is not a guarantee that every record has arrived. The Shopify data mapping explains the fields and synchronization directions to check.

Before you start

  • Sign in to the Shopify store you want to connect. You need permission to create, configure and install apps, or help from the store owner.
  • You need permission to edit your integration settings under Settings > Integrations in Optiply.
  • Keep passwords, app secrets and access tokens private. Enter connection values only into the fields requesting them in your signed-in Optiply account. Do not include them in chat, email, tickets or screenshots.
  • Have the store name and the required order-history period ready. If another system supplies products or stock, tell Optiply support before setup so that the connection uses the intended data sources.

Steps

1. Check the connection route in Optiply

  1. Open Settings > Integrations and select Add a source.
  2. Select Shopify, then Next. Read the fields and instructions under Connect to system before creating an app.
  3. If the dialog offers an authorization route, use that route. If it asks for your own app's connection details, prepare the app below. If it shows Contact us, use that action for assistance instead of creating a second connection.
  4. For help, provide the store name, whether products come from Shopify or another system, the history you need and the step that stopped you. Ask support to confirm the required permissions and connection method. Do not send sensitive values.

2. Create and configure the Shopify app

Use this section when your connection requires an app you manage. Shopify's Dev Dashboard app-creation guide describes this same route.

  1. Open the Dev Dashboard and select the organization that will own the app: your merchant organization for an own-store app, or the Partner organization managing a custom-distribution app.
  2. Open Apps > Create app, choose Start from Dev Dashboard, enter a recognizable app name and select Create.
  3. Open Versions and create a version. Complete the required app fields and choose the Scopes confirmed for your connection. Review inventory-write access carefully; do not add broader permissions to bypass an error.
  4. If you need orders older than Shopify's ordinary 60-day window, add read_all_orders only alongside the required read_orders or write_orders scope. Check Shopify's order-access requirements for the app's organization:
  5. If you need older orders for an app created in your store's merchant organization, you do not need to request Shopify approval for read_all_orders. Include the scope in the released version and check the installation's granted access. The store owner still approves requested access during installation.
  6. If older orders are required for a Partner organization app, first open Partner Dashboard > Apps, select the app and open API access requests. On the Read all orders scope card, select Request access, explain the need on the Orders page and submit Request access. Declare the scope after Shopify approves it.
  7. Select Release and confirm the version details. A saved draft version is not the released version used by an installation.
  8. Open the app. In the Installs card, select Install app, choose the intended store and select Install to approve the permissions shown.
  9. When the Optiply form requests the app credentials, open the app's Settings in the Dev Dashboard to find its Client ID and Secret. Keep these values private.

An app created in the store's merchant organization uses the Installs card above. Custom distribution is not an extra required step for that direct installation. The Distribution card is available only for apps in a Partner organization. If you manage such an app and need an install link for a specific store, use the custom-distribution route:

  1. Open the app in the Dev Dashboard. On Home, find Distribution. If no method is selected, choose Select distribution method, select Custom distribution and confirm. You cannot change the distribution method after selecting it.
  2. Select Manage custom install link. Enter the intended store's myshopify.com or admin.shopify.com domain. To restrict the link to that store, clear Allow multi-store installs for one Plus organization; multi-store installation is limited to stores in the same Plus organization.
  3. Select Generate link and send the install link to the store owner. The owner opens it and approves installation for the intended store. Share the link, not the app's secret.

3. Complete the connection and check the import

  1. Return to the Shopify connection dialog in Optiply. Complete the fields it requests for the intended store and select Connect. Do not substitute a temporary access token for an app secret or fill an unrequested field.
  2. Return to Settings > Integrations and expand the Shopify source. Check its connection state.
  3. Open Import jobs and read Job history. Use the refresh control to retrieve the latest job state; refreshing the list does not itself run an import.
  4. After the import finishes, compare a recognizable product and an expected order with Shopify using the mapping guide. Check the relevant variant, time period and data source before treating a difference as missing data.

Fields and permissions

Field or permissionMeaning
App nameA recognizable name for the app in Shopify.
Shop nameThe Shopify store to connect; use the form's requested format.
Client ID and SecretApp credentials. Supply them only when the connection form requests them.
Custom distributionStore-specific install-link distribution; separate from direct installation.
read_ordersRead orders within the ordinary order-access window.
Full order history / read_all_ordersExtends the accompanying order scope to older orders. Shopify approval depends on whether the app belongs to a merchant or Partner organization.
write_inventoryPermits inventory writes. Grant it only when required for the agreed connection.
read_locationsRead Shopify location information.
read_product_listings and read_productsRead product-listing and product information.
read_localesRead locale information.

These meanings help you review the requested access; they are not a reason to enable every permission in Shopify. Confirm the scope set for your connection before installation.

Expected result

The app has a released version installed in the intended store, and Shopify appears in Optiply's connected source list. Review the import job and sample records separately: Connected describes the connection state, not a guarantee that every product or historical order has arrived.

Limitations

The available connection fields and the data imported depend on your account's Shopify connection. An app's installation does not enable every data flow. Shopify also limits client-credentials authentication to apps and stores in the same Shopify organization; owning a store or installing an app does not automatically put both in that organization. Ask support to confirm the connection route rather than moving an app or changing distribution to work around a mismatch.

For a custom app installed on a store outside the app's organization, Shopify requires an IP allowlist for new installations from November 20, 2026. Apps already installed on external stores need one from January 1, 2027. Ask the app owner to prepare the required allowlist before the applicable date; do not guess the app's request IP addresses. For a custom app created before July 26, 2023, ask Shopify Support before enabling multi-store installation.

Errors and recovery

  • You cannot create or configure the app: ask the store owner to check your app-development permissions or perform those steps.
  • A permission is missing: edit the app version's access settings and release the corrected version. Complete any installation or approval prompts for the changed access; a release alone is not confirmation of store approval.
  • Older orders are missing: check the requested history period, the order-reading scope, granted access and any Shopify approval required for that app's organization before reconnecting or changing permissions.
  • An external-store custom app cannot be installed: have the app owner check the store domain, distribution method and applicable IP-allowlist requirement. Do not change the app's organization or distribution method to bypass the check.
  • The app is created but not installed: open the app's Installs card, select Install app and finish the store's approval.
  • Shopify is missing or Add a source is unavailable: check your Optiply settings permissions. If the source remains unavailable, use the support handoff in step 1.
  • The connection fails or the import is incomplete: note the step, visible error and job state, then use the same support handoff. Do not remove and recreate the source or broaden permissions as a first response.

For the next checks, read the integration overview.