The best selling ipod ever. Again
", "publishedOnCurrentPublication": true, "sortOrder": "MANUAL", "templateSuffix": null }, { "id": "gid://shopify/Collection/691652237", "handle": "non-ipods", "title": "Non Ipods", "updatedAt": "2013-02-02T00:00:00Z", "descriptionHtml": "No ipods here
", "publishedOnCurrentPublication": true, "sortOrder": "MANUAL", "templateSuffix": null }, { "id": "gid://shopify/Collection/841564295", "handle": "ipods", "title": "IPods", "updatedAt": "2008-02-02T00:00:00Z", "descriptionHtml": "The best selling ipod ever
", "publishedOnCurrentPublication": true, "sortOrder": "MANUAL", "templateSuffix": null } ] } } ``` * ### Retrieve a list of smart collections #### Description Retrieve the first 50 \[smart collections]\(https://help.shopify.com/manual/products/collections/smart-collections), using the \`collection\_type\` query filter. The response provides comprehensive details for each collection, including its ID, handle, title, last updated timestamp, description in HTML format, publication status, sort order, the suffix of the Liquid template being used to show the collection in the online store, and the rule set that defines the \[collection's conditions]\(https://help.shopify.com/manual/products/collections/smart-collections/conditions). > Note: > You must have the \`read\_product\_listings\` access scope to retrieve publication information. #### Query ```graphql query SmartCollectionList { collections(first: 50, query: "collection_type:smart") { nodes { id handle title updatedAt descriptionHtml publishedOnCurrentPublication sortOrder templateSuffix ruleSet { appliedDisjunctively rules { column relation condition conditionObject { ... on CollectionRuleMetafieldCondition { metafieldDefinition { id } } ... on CollectionRuleProductCategoryCondition { __typename } ... on CollectionRuleTextCondition { value } } } } } } } ``` #### cURL ```bash curl -X POST \ https://your-development-store.myshopify.com/admin/api/2026-10/graphql.json \ -H 'Content-Type: application/json' \ -H 'X-Shopify-Access-Token: {access_token}' \ -d '{ "query": "query SmartCollectionList { collections(first: 50, query: \"collection_type:smart\") { nodes { id handle title updatedAt descriptionHtml publishedOnCurrentPublication sortOrder templateSuffix ruleSet { appliedDisjunctively rules { column relation condition conditionObject { ... on CollectionRuleMetafieldCondition { metafieldDefinition { id } } ... on CollectionRuleProductCategoryCondition { __typename } ... on CollectionRuleTextCondition { value } } } } } } }" }' ``` #### React Router ```javascript import { authenticate } from "../shopify.server"; export const loader = async ({request}) => { const { admin } = await authenticate.admin(request); const response = await admin.graphql( `#graphql query SmartCollectionList { collections(first: 50, query: "collection_type:smart") { nodes { id handle title updatedAt descriptionHtml publishedOnCurrentPublication sortOrder templateSuffix ruleSet { appliedDisjunctively rules { column relation condition conditionObject { ... on CollectionRuleMetafieldCondition { metafieldDefinition { id } } ... on CollectionRuleProductCategoryCondition { __typename } ... on CollectionRuleTextCondition { value } } } } } } }`, ); const json = await response.json(); return json.data; } ``` #### Ruby ```ruby session = ShopifyAPI::Auth::Session.new( shop: "your-development-store.myshopify.com", access_token: access_token ) client = ShopifyAPI::Clients::Graphql::Admin.new( session: session ) query = <<~QUERY query SmartCollectionList { collections(first: 50, query: "collection_type:smart") { nodes { id handle title updatedAt descriptionHtml publishedOnCurrentPublication sortOrder templateSuffix ruleSet { appliedDisjunctively rules { column relation condition conditionObject { ... on CollectionRuleMetafieldCondition { metafieldDefinition { id } } ... on CollectionRuleProductCategoryCondition { __typename } ... on CollectionRuleTextCondition { value } } } } } } } QUERY response = client.query(query: query) ``` #### Node.js ```javascript const client = new shopify.clients.Graphql({session}); const data = await client.query({ data: `query SmartCollectionList { collections(first: 50, query: "collection_type:smart") { nodes { id handle title updatedAt descriptionHtml publishedOnCurrentPublication sortOrder templateSuffix ruleSet { appliedDisjunctively rules { column relation condition conditionObject { ... on CollectionRuleMetafieldCondition { metafieldDefinition { id } } ... on CollectionRuleProductCategoryCondition { __typename } ... on CollectionRuleTextCondition { value } } } } } } }`, }); ``` #### Shopify CLI ```bash shopify app execute \ --query \ 'query SmartCollectionList { collections(first: 50, query: "collection_type:smart") { nodes { id handle title updatedAt descriptionHtml publishedOnCurrentPublication sortOrder templateSuffix ruleSet { appliedDisjunctively rules { column relation condition conditionObject { ... on CollectionRuleMetafieldCondition { metafieldDefinition { id } } ... on CollectionRuleProductCategoryCondition { __typename } ... on CollectionRuleTextCondition { value } } } } } } }' ``` #### Direct API Access ```javascript const response = await fetch('shopify:admin/api/2026-10/graphql.json', { method: 'POST', body: JSON.stringify({ query: ` query SmartCollectionList { collections(first: 50, query: "collection_type:smart") { nodes { id handle title updatedAt descriptionHtml publishedOnCurrentPublication sortOrder templateSuffix ruleSet { appliedDisjunctively rules { column relation condition conditionObject { ... on CollectionRuleMetafieldCondition { metafieldDefinition { id } } ... on CollectionRuleProductCategoryCondition { __typename } ... on CollectionRuleTextCondition { value } } } } } } } `, }), }); const { data } = await response.json(); console.log(data); ``` #### Response ```json { "collections": { "nodes": [ { "id": "gid://shopify/Collection/482865238", "handle": "smart-ipods", "title": "Smart iPods", "updatedAt": "2008-02-02T00:00:00Z", "descriptionHtml": "The best selling ipod ever
", "publishedOnCurrentPublication": true, "sortOrder": "MANUAL", "templateSuffix": null, "ruleSet": { "appliedDisjunctively": false, "rules": [ { "column": "TYPE", "relation": "EQUALS", "condition": "Cult Products", "conditionObject": { "value": "Cult Products" } } ] } } ] } } ``` * ### Retrieve collections with their sources #### Description Retrieve a list of collections with the sources that determine their product membership. Use inline fragments to request fields that belong to each source type. #### Query ```graphql query CollectionsWithSources { collections(first: 5) { nodes { id title sources { __typename id title ... on CollectionConditionsSource { inclusion { matchType conditions { __typename id ... on CollectionSourceInclusionConditionProductTag { relation values matchType } } } } ... on CollectionSubCollectionSource { subCollection { id title } } } } } } ``` #### cURL ```bash curl -X POST \ https://your-development-store.myshopify.com/admin/api/2026-10/graphql.json \ -H 'Content-Type: application/json' \ -H 'X-Shopify-Access-Token: {access_token}' \ -d '{ "query": "query CollectionsWithSources { collections(first: 5) { nodes { id title sources { __typename id title ... on CollectionConditionsSource { inclusion { matchType conditions { __typename id ... on CollectionSourceInclusionConditionProductTag { relation values matchType } } } } ... on CollectionSubCollectionSource { subCollection { id title } } } } } }" }' ``` #### React Router ```javascript import { authenticate } from "../shopify.server"; export const loader = async ({request}) => { const { admin } = await authenticate.admin(request); const response = await admin.graphql( `#graphql query CollectionsWithSources { collections(first: 5) { nodes { id title sources { __typename id title ... on CollectionConditionsSource { inclusion { matchType conditions { __typename id ... on CollectionSourceInclusionConditionProductTag { relation values matchType } } } } ... on CollectionSubCollectionSource { subCollection { id title } } } } } }`, ); const json = await response.json(); return json.data; } ``` #### Ruby ```ruby session = ShopifyAPI::Auth::Session.new( shop: "your-development-store.myshopify.com", access_token: access_token ) client = ShopifyAPI::Clients::Graphql::Admin.new( session: session ) query = <<~QUERY query CollectionsWithSources { collections(first: 5) { nodes { id title sources { __typename id title ... on CollectionConditionsSource { inclusion { matchType conditions { __typename id ... on CollectionSourceInclusionConditionProductTag { relation values matchType } } } } ... on CollectionSubCollectionSource { subCollection { id title } } } } } } QUERY response = client.query(query: query) ``` #### Node.js ```javascript const client = new shopify.clients.Graphql({session}); const data = await client.query({ data: `query CollectionsWithSources { collections(first: 5) { nodes { id title sources { __typename id title ... on CollectionConditionsSource { inclusion { matchType conditions { __typename id ... on CollectionSourceInclusionConditionProductTag { relation values matchType } } } } ... on CollectionSubCollectionSource { subCollection { id title } } } } } }`, }); ``` #### Shopify CLI ```bash shopify app execute \ --query \ 'query CollectionsWithSources { collections(first: 5) { nodes { id title sources { __typename id title ... on CollectionConditionsSource { inclusion { matchType conditions { __typename id ... on CollectionSourceInclusionConditionProductTag { relation values matchType } } } } ... on CollectionSubCollectionSource { subCollection { id title } } } } } }' ``` #### Direct API Access ```javascript const response = await fetch('shopify:admin/api/2026-10/graphql.json', { method: 'POST', body: JSON.stringify({ query: ` query CollectionsWithSources { collections(first: 5) { nodes { id title sources { __typename id title ... on CollectionConditionsSource { inclusion { matchType conditions { __typename id ... on CollectionSourceInclusionConditionProductTag { relation values matchType } } } } ... on CollectionSubCollectionSource { subCollection { id title } } } } } } `, }), }); const { data } = await response.json(); console.log(data); ``` #### Response ```json { "collections": { "nodes": [ { "id": "gid://shopify/Collection/79210309", "title": "Custom Other Items", "sources": [] }, { "id": "gid://shopify/Collection/90485875", "title": "Collection Snowboards", "sources": [ { "__typename": "CollectionConditionsSource", "id": "gid://shopify/CollectionConditionsSource/534160395", "title": "Snowboards Collection Source with Legacy Rules", "inclusion": { "matchType": "ALL", "conditions": [ { "__typename": "CollectionSourceInclusionConditionProductTag", "id": "gid://shopify/CollectionSourceInclusionConditionProductTag/296447442", "relation": "TAGGED_WITH", "values": [ "original_tag" ], "matchType": "ALL" }, { "__typename": "CollectionSourceInclusionConditionProductVendor", "id": "gid://shopify/CollectionSourceInclusionConditionProductVendor/650881667" }, { "__typename": "CollectionSourceInclusionConditionProductType", "id": "gid://shopify/CollectionSourceInclusionConditionProductType/940916807" } ] } } ] }, { "id": "gid://shopify/Collection/94229130", "title": "All products more expensive than free", "sources": [] }, { "id": "gid://shopify/Collection/142458073", "title": "All snowboards", "sources": [] }, { "id": "gid://shopify/Collection/247865063", "title": "Collection Snowboards", "sources": [ { "__typename": "CollectionConditionsSource", "id": "gid://shopify/CollectionConditionsSource/562928290", "title": "Snowboards Collection Source", "inclusion": { "matchType": "ALL", "conditions": [] } } ] } ] } } ``` * ### Retrieve the first five collections #### Description Retrieve the first five collections in a store. The response returns a list of the collections, including the collection ID, title, handle, last updated timestamp, and \[sort order]\(https://shopify.dev/docs/api/admin-graphql/latest/enums/CollectionSortOrder). #### Query ```graphql query { collections(first: 5) { edges { node { id title handle updatedAt sortOrder } } } } ``` #### cURL ```bash curl -X POST \ https://your-development-store.myshopify.com/admin/api/2026-10/graphql.json \ -H 'Content-Type: application/json' \ -H 'X-Shopify-Access-Token: {access_token}' \ -d '{ "query": "query { collections(first: 5) { edges { node { id title handle updatedAt sortOrder } } } }" }' ``` #### React Router ```javascript import { authenticate } from "../shopify.server"; export const loader = async ({request}) => { const { admin } = await authenticate.admin(request); const response = await admin.graphql( `#graphql query { collections(first: 5) { edges { node { id title handle updatedAt sortOrder } } } }`, ); const json = await response.json(); return json.data; } ``` #### Ruby ```ruby session = ShopifyAPI::Auth::Session.new( shop: "your-development-store.myshopify.com", access_token: access_token ) client = ShopifyAPI::Clients::Graphql::Admin.new( session: session ) query = <<~QUERY query { collections(first: 5) { edges { node { id title handle updatedAt sortOrder } } } } QUERY response = client.query(query: query) ``` #### Node.js ```javascript const client = new shopify.clients.Graphql({session}); const data = await client.query({ data: `query { collections(first: 5) { edges { node { id title handle updatedAt sortOrder } } } }`, }); ``` #### Shopify CLI ```bash shopify app execute \ --query \ 'query { collections(first: 5) { edges { node { id title handle updatedAt sortOrder } } } }' ``` #### Direct API Access ```javascript const response = await fetch('shopify:admin/api/2026-10/graphql.json', { method: 'POST', body: JSON.stringify({ query: ` query { collections(first: 5) { edges { node { id title handle updatedAt sortOrder } } } } `, }), }); const { data } = await response.json(); console.log(data); ``` #### Response ```json { "collections": { "edges": [ { "node": { "id": "gid://shopify/Collection/79210309", "title": "Custom Other Items", "handle": "reorder_custom", "updatedAt": "2008-10-10T00:00:00Z", "sortOrder": "MANUAL" } }, { "node": { "id": "gid://shopify/Collection/90485875", "title": "Collection Snowboards", "handle": "collection_snowboards_via_sources_with_legacy_rules", "updatedAt": "2006-02-02T00:00:00Z", "sortOrder": "ALPHA_ASC" } }, { "node": { "id": "gid://shopify/Collection/94229130", "title": "All products more expensive than free", "handle": "everything", "updatedAt": "2006-02-02T00:00:00Z", "sortOrder": "MANUAL" } }, { "node": { "id": "gid://shopify/Collection/142458073", "title": "All snowboards", "handle": "snowboards", "updatedAt": "2006-02-02T00:00:00Z", "sortOrder": "MANUAL" } }, { "node": { "id": "gid://shopify/Collection/247865063", "title": "Collection Snowboards", "handle": "collection_snowboards_via_sources", "updatedAt": "2006-02-02T00:00:00Z", "sortOrder": "ALPHA_ASC" } } ] } } ``` * ### Retrieve the five most recently updated smart collections #### Description Retrieve the five most recently updated \[smart collections]\(https://help.shopify.com/manual/products/collections/smart-collections), using the \`collection\_type\` query filter and sorting by when they were last modified (\`UPDATED\_AT\` in reverse order). This query is useful for finding collections that have been recently changed. The response returns a list of collections, including their ID, title, handle, update timestamp, and \[sort order]\(https://shopify.dev/docs/api/admin-graphql/latest/enums/CollectionSortOrder). #### Query ```graphql query { collections(first: 5, query: "collection_type:smart", sortKey: UPDATED_AT, reverse: true) { edges { node { id title handle updatedAt sortOrder } } } } ``` #### cURL ```bash curl -X POST \ https://your-development-store.myshopify.com/admin/api/2026-10/graphql.json \ -H 'Content-Type: application/json' \ -H 'X-Shopify-Access-Token: {access_token}' \ -d '{ "query": "query { collections(first: 5, query: \"collection_type:smart\", sortKey: UPDATED_AT, reverse: true) { edges { node { id title handle updatedAt sortOrder } } } }" }' ``` #### React Router ```javascript import { authenticate } from "../shopify.server"; export const loader = async ({request}) => { const { admin } = await authenticate.admin(request); const response = await admin.graphql( `#graphql query { collections(first: 5, query: "collection_type:smart", sortKey: UPDATED_AT, reverse: true) { edges { node { id title handle updatedAt sortOrder } } } }`, ); const json = await response.json(); return json.data; } ``` #### Ruby ```ruby session = ShopifyAPI::Auth::Session.new( shop: "your-development-store.myshopify.com", access_token: access_token ) client = ShopifyAPI::Clients::Graphql::Admin.new( session: session ) query = <<~QUERY query { collections(first: 5, query: "collection_type:smart", sortKey: UPDATED_AT, reverse: true) { edges { node { id title handle updatedAt sortOrder } } } } QUERY response = client.query(query: query) ``` #### Node.js ```javascript const client = new shopify.clients.Graphql({session}); const data = await client.query({ data: `query { collections(first: 5, query: "collection_type:smart", sortKey: UPDATED_AT, reverse: true) { edges { node { id title handle updatedAt sortOrder } } } }`, }); ``` #### Shopify CLI ```bash shopify app execute \ --query \ 'query { collections(first: 5, query: "collection_type:smart", sortKey: UPDATED_AT, reverse: true) { edges { node { id title handle updatedAt sortOrder } } } }' ``` #### Direct API Access ```javascript const response = await fetch('shopify:admin/api/2026-10/graphql.json', { method: 'POST', body: JSON.stringify({ query: ` query { collections(first: 5, query: "collection_type:smart", sortKey: UPDATED_AT, reverse: true) { edges { node { id title handle updatedAt sortOrder } } } } `, }), }); const { data } = await response.json(); console.log(data); ``` #### Response ```json { "collections": { "edges": [ { "node": { "id": "gid://shopify/Collection/522532842", "title": "Frisbees", "handle": "reorder_smart_frisbees", "updatedAt": "2008-10-12T00:00:00Z", "sortOrder": "MANUAL" } }, { "node": { "id": "gid://shopify/Collection/1063001310", "title": "Smart Other items", "handle": "reorder_smart", "updatedAt": "2008-10-11T00:00:00Z", "sortOrder": "MANUAL" } }, { "node": { "id": "gid://shopify/Collection/1009501285", "title": "Dummy", "handle": "blank", "updatedAt": "2006-02-02T00:00:00Z", "sortOrder": "MANUAL" } }, { "node": { "id": "gid://shopify/Collection/925420914", "title": "All snowboards called Draft", "handle": "drafts", "updatedAt": "2006-02-02T00:00:00Z", "sortOrder": "MANUAL" } }, { "node": { "id": "gid://shopify/Collection/803831625", "title": "Conditional Snowboards", "handle": "collection_snowboards_with_existing_condition", "updatedAt": "2006-02-02T00:00:00Z", "sortOrder": "ALPHA_ASC" } } ] } } ```