Choose a version:

productResourceFeedback

query

Requires read_resource_feedbacks access scope. Also: App must be configured to use the Storefront API or as a Sales Channel.

Retrieves product resource feedback for the currently authenticated app, providing insights into product data quality, completeness, and optimization opportunities. This feedback helps apps guide merchants toward better product listings and improved store performance.

For example, an SEO app might receive feedback indicating that certain products lack meta descriptions or have suboptimal titles, enabling the app to provide specific recommendations for improving search visibility and conversion rates.

Use ProductResourceFeedback to:

Display product optimization recommendations to merchants
Identify data quality issues across product catalogs
Build product improvement workflows and guided experiences
Track progress on product listing completeness and quality
Implement automated product auditing and scoring systems
Generate reports on catalog health and optimization opportunities
Provide contextual suggestions within product editing interfaces

The feedback system evaluates products against various criteria including SEO best practices, required fields, media quality, and sales channel requirements. Each feedback item includes specific details about the issue, suggested improvements, and priority levels.

Feedback is app-specific and reflects the particular focus of your application - marketing apps receive different insights than inventory management apps. The system continuously updates as merchants make changes, providing real-time guidance for product optimization.

This resource is particularly valuable for apps that help merchants improve their product listings, optimize for search engines, or enhance their overall catalog quality. The feedback enables proactive suggestions rather than reactive problem-solving.

Learn more about product optimization.

Anchor to Arguments

Arguments

Anchor to idid •ID! required: The product associated with the resource feedback.

Was this section helpful?

Anchor to Possible returnsPossible returns

Anchor to ProductResourceFeedbackProductResourceFeedback •ProductResourceFeedback: Reports the status of product for a Sales Channel or Storefront API. This might include why a product is not available in a Sales Channel and how a merchant might fix this.

Was this section helpful?

Examples

Get a product resource feedback record by ID that doesn't exist

Description

Trying to retrieve a feedback for a non-existent product returns `null`.

Query

query {
  productResourceFeedback(id: "gid://shopify/Product/-1") {
    feedbackGeneratedAt
    messages
    productId
    productUpdatedAt
    state
  }
}

cURL

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2025-07/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "query { productResourceFeedback(id: \"gid://shopify/Product/-1\") { feedbackGeneratedAt messages productId productUpdatedAt state } }"
}'

Remix

const { admin } = await authenticate.admin(request);

const response = await admin.graphql(
  `#graphql
  query {
    productResourceFeedback(id: "gid://shopify/Product/-1") {
      feedbackGeneratedAt
      messages
      productId
      productUpdatedAt
      state
    }
  }`,
);

const data = await response.json();

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 {
    productResourceFeedback(id: "gid://shopify/Product/-1") {
      feedbackGeneratedAt
      messages
      productId
      productUpdatedAt
      state
    }
  }
QUERY

response = client.query(query: query)

Node.js

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: `query {
    productResourceFeedback(id: "gid://shopify/Product/-1") {
      feedbackGeneratedAt
      messages
      productId
      productUpdatedAt
      state
    }
  }`,
});

Response

{
  "productResourceFeedback": null
}

Receive a list of all Product ResourceFeedbacks

Query

query {
  productResourceFeedback(id: "gid://shopify/Product/1048875085") {
    feedbackGeneratedAt
    messages
    productId
    productUpdatedAt
    state
  }
}

cURL

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2025-07/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "query { productResourceFeedback(id: \"gid://shopify/Product/1048875085\") { feedbackGeneratedAt messages productId productUpdatedAt state } }"
}'

Remix

const { admin } = await authenticate.admin(request);

const response = await admin.graphql(
  `#graphql
  query {
    productResourceFeedback(id: "gid://shopify/Product/1048875085") {
      feedbackGeneratedAt
      messages
      productId
      productUpdatedAt
      state
    }
  }`,
);

const data = await response.json();

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 {
    productResourceFeedback(id: "gid://shopify/Product/1048875085") {
      feedbackGeneratedAt
      messages
      productId
      productUpdatedAt
      state
    }
  }
QUERY

response = client.query(query: query)

Node.js

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: `query {
    productResourceFeedback(id: "gid://shopify/Product/1048875085") {
      feedbackGeneratedAt
      messages
      productId
      productUpdatedAt
      state
    }
  }`,
});

Response

{
  "productResourceFeedback": {
    "feedbackGeneratedAt": "2024-11-14T20:48:48Z",
    "messages": [
      "Needs an image."
    ],
    "productId": "gid://shopify/Product/1048875085",
    "productUpdatedAt": "2024-11-14T20:48:48Z",
    "state": "REQUIRES_ACTION"
  }
}

Examples

Open in GraphiQL

const { admin } = await authenticate.admin(request);

const response = await admin.graphql(

`#graphql

query {

productResourceFeedback(id: "gid://shopify/Product/-1") {

feedbackGeneratedAt

messages

productId

productUpdatedAt

state

}

}`,

);

const data = await response.json();

query {
  productResourceFeedback(id: "gid://shopify/Product/-1") {
    feedbackGeneratedAt
    messages
    productId
    productUpdatedAt
    state
  }
}

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2025-07/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "query { productResourceFeedback(id: \"gid://shopify/Product/-1\") { feedbackGeneratedAt messages productId productUpdatedAt state } }"
}'

const { admin } = await authenticate.admin(request);

const response = await admin.graphql(
  `#graphql
  query {
    productResourceFeedback(id: "gid://shopify/Product/-1") {
      feedbackGeneratedAt
      messages
      productId
      productUpdatedAt
      state
    }
  }`,
);

const data = await response.json();

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: `query {
    productResourceFeedback(id: "gid://shopify/Product/-1") {
      feedbackGeneratedAt
      messages
      productId
      productUpdatedAt
      state
    }
  }`,
});

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 {
    productResourceFeedback(id: "gid://shopify/Product/-1") {
      feedbackGeneratedAt
      messages
      productId
      productUpdatedAt
      state
    }
  }
QUERY

response = client.query(query: query)

Response

JSON

{

"productResourceFeedback": null

}