Merchant eligibility

For your Shop Mini to appear on a merchants' surfaces in the Shop app:

• they must have the Shop channel installed
• they must meet the Shop eligibility criteria
• they must have your Shopify app installed

Shop eligibility

You can determine if a merchant has the Shop channel installed and meets the Shop eligibility criteria by using the shopEligibilities field in the Shop Minis Admin API:

GraphQL

query {
  shopEligibilities(
    shopDomains: ["shop1.myshopify.com", "shop2.myshopify.com"]
  ) {
    shopDomain
    status
  }
}

Response

{
  "shopEligibilities": [
    {
      "shopDomain": "shop1.myshopify.com",
      "status": "ELIGIBLE"
    },
    {
      "shopDomain": "shop2.myshopify.com",
      "status": "INELIGIBLE"
    }
  ]
}

Product eligibility

You can also determine if a particular product meets the Shop eligibility criteria by using the productEligibilities field in the Shop Minis Admin API. This is particularly useful if when allowing merchants to select eligible products in your Shopify app admin UI.

GraphQL

query {
  productEligibilities(
    productIds: ["gid://shopify/Product/42", "gid://shopify/Product/101"]
  ) {
    productId
    status
  }
}

Response

{
  "productEligibilities": [
    {
      "productId": "gid://shopify/Product/42",
      "status": "INELIGIBLE"
    },
    {
      "productId": "gid://shopify/Product/101",
      "status": "ELIGIBLE"
    }
  ]
}