diff --git a/src/pages/graphql/schema/catalog-service/queries/product-variants.md b/src/pages/graphql/schema/catalog-service/queries/product-variants.md
index eee229de3..257ae252c 100644
--- a/src/pages/graphql/schema/catalog-service/queries/product-variants.md
+++ b/src/pages/graphql/schema/catalog-service/queries/product-variants.md
@@ -717,7 +717,7 @@ The `ProductViewImage` type contains details about a product image.
 | Field | Data Type | Description |
 | --- | --- | --- |
 | `label` | String | The display label of the product image. |
-| `roles` | [String] | A list that describes how the image is used. Can be `image`, `small_image`, or `thumbnail`. |
+| `roles` | [String] | A list that describes how the image is used. Includes the standard roles (`image`, `small_image`, `thumbnail`, `swatch_image`) and any merchant-defined custom role values, such as `lifestyle_image`. |
 | `url` | String! | The URL to the product image. |
 
 ### ProductViewLink type
diff --git a/src/pages/graphql/schema/catalog-service/queries/products.md b/src/pages/graphql/schema/catalog-service/queries/products.md
index 5fb8ee5ec..e9e22a676 100644
--- a/src/pages/graphql/schema/catalog-service/queries/products.md
+++ b/src/pages/graphql/schema/catalog-service/queries/products.md
@@ -926,7 +926,7 @@ The `ProductViewImage` type contains details about a product image.
 | Field | Data Type | Description |
 | --- | --- | --- |
 | `label` | String | The display label of the product image. |
-| `roles` | [String] | A list that describes how the image is used. Can be `image`, `small_image`, or `thumbnail`. |
+| `roles` | [String] | A list that describes how the image is used. Includes the standard roles (`image`, `small_image`, `thumbnail`, `swatch_image`) and any merchant-defined custom role values, such as `lifestyle_image`. |
 | `url` | String! | The URL to the product image. |
 
 ### ProductViewLink type
diff --git a/src/pages/graphql/schema/catalog-service/queries/refine-product.md b/src/pages/graphql/schema/catalog-service/queries/refine-product.md
index fb3039c7c..941fd68dc 100644
--- a/src/pages/graphql/schema/catalog-service/queries/refine-product.md
+++ b/src/pages/graphql/schema/catalog-service/queries/refine-product.md
@@ -374,7 +374,7 @@ The `ProductViewImage` type contains details about a product image.
 | Field | Data Type | Description |
 | --- | --- | --- |
 | `label` | String | The display label of the product image. |
-| `roles` | [String] | A list that describes how the image is used. Can be `image`, `small_image`, or `thumbnail`. |
+| `roles` | [String] | A list that describes how the image is used. Includes the standard roles (`image`, `small_image`, `thumbnail`, `swatch_image`) and any merchant-defined custom role values, such as `lifestyle_image`. |
 | `url` | String! | The URL to the product image. |
 
 ### ProductViewLink type
diff --git a/src/pages/graphql/schema/live-search/queries/product-search.md b/src/pages/graphql/schema/live-search/queries/product-search.md
index 37554341d..cdcc8aa7e 100644
--- a/src/pages/graphql/schema/live-search/queries/product-search.md
+++ b/src/pages/graphql/schema/live-search/queries/product-search.md
@@ -1134,7 +1134,7 @@ The `ProductViewImage` type contains details about a product image.
 | Field | Data Type | Description |
 | --- | --- | --- |
 | `label` | String | The display label of the product image. |
-| `roles` | [String] | A list that describes how the image is used. Can be `image`, `small_image`, or `thumbnail`. |
+| `roles` | [String] | A list that describes how the image is used. Includes the standard roles (`image`, `small_image`, `thumbnail`, `swatch_image`) and any merchant-defined custom role values, such as `lifestyle_image`. |
 | `url` | String! | The URL to the product image. |
 
 ### ProductViewLink type
diff --git a/src/pages/includes/graphql/catalog-service/product-view.md b/src/pages/includes/graphql/catalog-service/product-view.md
index ad3de76b9..b9440b9c1 100644
--- a/src/pages/includes/graphql/catalog-service/product-view.md
+++ b/src/pages/includes/graphql/catalog-service/product-view.md
@@ -92,7 +92,7 @@ The `ProductViewImage` type contains details about a product image.
 | Field | Data Type | Description |
 | --- | --- | --- |
 | `label` | String | The display label of the product image. |
-| `roles` | [String] | A list that describes how the image is used. Can be `image`, `small_image`, or `thumbnail`. |
+| `roles` | [String] | A list that describes how the image is used. Includes the standard roles (`image`, `small_image`, `thumbnail`, `swatch_image`) and any merchant-defined custom role values, such as `lifestyle_image`. |
 | `url` | String! | The URL to the product image. |
 
 ### ProductViewLink type