Skip to main content
Your Shopify catalog is Asa’s most important content source. Connect your store, then choose exactly what Asa should learn from. Today, use the Custom app path. The official Asa Shopify app is in App Store review and is not generally available yet. Once it is approved, you will be able to install from the Shopify App Store instead of creating a custom app.
Use this path now — connect Asa with a Shopify custom app and Admin API credentials from the Shopify Dev Dashboard.

Create a custom app in Shopify

In your Shopify admin, go to Settings > Apps and sales channels, then Develop apps and open Build apps in Dev Dashboard.Click Create app and name it Asa Custom App, then click Create.
If you cannot access the Dev Dashboard, you may lack the required permissions. Ask your store admin. For help from Asa, email help@alphablocks.ai.

Add Admin API scopes and install

In your custom app, open Access > Scopes and paste these scopes:
read_app_proxy,read_content,read_customer_events,read_customers,read_discounts,read_fulfillments,read_inventory,read_legal_policies,read_metaobject_definitions,read_metaobjects,read_online_store_pages,read_orders,read_pixels,read_product_listings,read_products,read_publications,read_themes,write_app_proxy,write_pixels
Click Release, then Install and select the store to install on.

Copy Client ID and Secret

Open the Settings tab in your custom app.Under Credentials, copy the Client ID and Secret — you need both in Asa.

Connect in Asa

Navigate to Add Content in the sidebar, open the Apps tab, and click Connect on the Shopify (Custom App) card.
Connect to Shopify Legacy dialog with Client ID, Client Secret, Storefront Public URL, and Shopify Subdomain
Enter your credentials:
FieldWhat to paste
Client IDClient ID from your custom app
Client SecretSecret from your custom app
Storefront Public URLYour live store URL (e.g. https://acme.com)
Shopify SubdomainSubdomain from Settings > Domains — the part before .myshopify.com
Example: if your admin URL is https://admin.shopify.com/store/acme/settings/domains, your subdomain is acme.Click Connect. When setup succeeds, the card shows Connected.
Connecting Shopify does not train Asa on your catalog yet. You choose what to train in the next section.

​
Select content and train

After Shopify connects — on either path — the content selection dialog opens automatically. If it does not, open the Connected menu on the Shopify card and choose Manage integration.

Choose catalog content

In Allow Asa to access these data sources, select what Asa should learn from — for example Products, Blogs, Pages, and Policies.
Shopify content selection dialog with Products, Blogs, Pages, and Policies categories

Select metafields (if applicable)

If you selected products, click Next to open Select Metafields and choose which product metafields Asa should use.Click Proceed to start training. If you did not select products, click Proceed from the content screen instead.Training usually takes a few minutes depending on how much you selected.
Go to Manage Content and confirm your Shopify sources show a Trained status.

​
Keep content up to date

ActionHow
Add or change catalog contentOn the Shopify card, open Connected → Manage integration to update your selection.
Retrain after Shopify editsUpdate products or pages in Shopify, then retrain from Manage Content.
Custom app permissionsCustom app setup must include all Admin API scopes from the Add Admin API scopes step — Asa only accesses what you grant.
To put Asa on your storefront after training, go to Configuration > Deploy and follow the Shopify channel instructions.

​
Notes

  • Until the Asa Shopify app is approved, use the Custom app path and the Shopify (Custom App) card in Add Content.
  • After App Store approval, the Shopify app tab describes the install-from-store flow.
  • Double-check credentials and store URLs — typos are the most common connection failure.
  • Only the scopes or permissions you approve are used by Asa.
If you need help, reach out at help@alphablocks.ai.