[meker12]

Summary

Clarify support for standard and merchant-defined custom image roles in Catalog Service and Live Search GraphQL documentation.

JIRA: ACAP-1272

Changes

• Add swatch_image to the documented standard image roles.
• Clarify that ProductViewImage.roles can include merchant-defined custom values, such as lifestyle_image.
• Update the Catalog Service products, productVariants, and refineProduct references, the shared ProductView documentation, and the Live Search productSearch reference.
• Update the products overview to reflect custom image role support.

whatsnew
The ProductViewImage type in the Catalog Service GraphQL API now returns custom image roles, in addition to the standard image, small_image, thumbnail, and swatch_image roles. Merchants can define their own roles in AEM Assets, and storefronts can query them to display the right image in the right context, such as a lifestyle shot or a size chart. See product queries for details.

[github-actions]

🔍 Linter Report

Click to expand full report

═══════════════════════════════════════════════════════════════
                     LINTER REPORT
═══════════════════════════════════════════════════════════════

Generated: 2026-10-29T00:40:36.522Z
Mode: Full Linting (all rules + dead links check)
Target Directory: /home/runner/work/commerce-webapi/commerce-webapi
Skipped Rules:
  - check-frontmatter → src/pages/includes
  - missing-heading → src/pages/includes

───────────────────────────────────────────────────────────────

Files to process: 5


═══════════════════════════════════════════════════════════════
                        SUMMARY
═══════════════════════════════════════════════════════════════

  📁 Files processed:    5
  📄 Files with issues:  0
  ❌ Total errors:       0
  ⚠️  Total warnings:     0
  📋 Total issues:       0

Result: ✅ PASSED - All files passed linting successfully!

═══════════════════════════════════════════════════════════════

---

This comment was automatically generated by the linter bot.