Blueprints

Shopify Custom

Run your Shopify store from Ren — products, orders, customers, and ShopifyQL analytics

  • @Shopify Custom Build a Shopify app or theme with current docs.

  • @Shopify Custom Generate and validate a Shopify GraphQL operation.

  • @Shopify Custom Use Shopify CLI to run or troubleshoot a store workflow.

Work your Shopify Admin API directly from Ren. Manage products, variants, inventory, orders, customers, discounts, and metafields, and pull the numbers behind them with ShopifyQL — sales, AOV, discounts, returns, sessions, and checkout funnels. Ask for a record and get the record; ask for a trend and get the query. Reporting runs read-only, so analysis never risks a write to your catalogue.

Skills

2
  • shopifyShopify Admin & Storefront GraphQL APIs via curl. Manage products, orders, customers, inventory, metafields, bulk operations, and webhooks. Use when working with a Shopify store programmatically — listing products, updating inventory, pulling orders, managing customers, or setting metafields.
  • shopify-reportingRead-only Shopify analytics with ShopifyQL over the Admin GraphQL API. Use when the ask is for numbers rather than records — totals, rates, trends, funnels, or breakdowns across sales, orders, AOV, discounts, returns, sessions, checkout conversion, traffic sources, inventory, payments, or fulfilment speed, sliced by dimension, bucketed over time, or compared period-over-period. Use for "checkout funnel last month", "why did conversion drop", "sales by channel this quarter vs last", "top landing pages by completed checkouts", even when the user does not say "report" or "analytics". Not for fetching or changing individual products, orders, or customers — that is the shopify skill.

Information

Setup

Set up Shopify Custom

Complete these steps before you use this App.

What you need

  • SHOPIFY_STORE_DOMAIN — Permanent myshopify.com subdomain, e.g. my-store.myshopify.com.
  • SHOPIFY_CLIENT_ID — Client ID from the app's Settings page in Shopify's Dev Dashboard.
  • SHOPIFY_CLIENT_SECRET — Client secret from the app's Settings page in Shopify's Dev Dashboard.

Setup guide

Watch the Shopify setup video tutorial for a walkthrough of these steps.

  1. Enter your store's permanent *.myshopify.com domain. Find it in Shopify admin under Settings, beneath your store name.
  2. Open the Shopify Dev Dashboard. See Shopify's Dev Dashboard documentation for an overview.
  3. Select Apps > Create app > Start from Dev Dashboard. Name the app, then click Create.
  4. On the Versions tab, select the scopes Ren needs. Start with read_products, read_orders, and read_reports for ShopifyQL analytics. Add read_customers only when required. See the complete Shopify API access scope list, then click Release.
  5. Select Home > Install app, choose your store, and click Install to authorize the app.
  6. Open Settings, then copy the Client ID and Client secret.
  7. Return to the Shopify connect card in Ren. Paste the Client ID and Client secret.
  8. Ren verifies the connection by reading your store name. When the card shows that Shopify is connected, click Continue.
  9. Ask Ren to pull the details for one product to verify that it can read your Shopify data.

Notes:

  • Your store domain is the permanent *.myshopify.com subdomain, not your custom domain.
  • A Dev Dashboard app only reaches stores in its own Shopify organization. For a client's store, the client creates the app in their organization and shares the client ID and secret, or adds you to that organization with app-development permission. shop_not_permitted on the token request means the app and the store are in different organizations.
  • read_orders covers the last 60 days of orders; read_all_orders is needed for older ones. Report totals come from ShopifyQL and are not subject to that window.
  • Ren obtains and renews Shopify access tokens from the client credentials. You do not need to create or refresh an access token.
  • Ren currently holds one Shopify connection per pod.
Open the full setup guide