Changelog

Carts API: custom items don’t support images

We’ve clarified that custom cart items don’t support images. The image_url field on a custom item is accepted by the API but does not render on the storefront.

• Carts v3 schemas — image_url descriptions on cart_PostCustomItem, ItemCustomGet, and ItemCustom now note that the field isn’t rendered for custom items
• Endpoint usage notes — added the limitation to the Create a Cart and Add Cart Line Items operations
• Request examples — removed misleading image_url values from custom item examples
• Headless carts guide — added a callout to the Working with carts page
• Checkout & Orders REST API course — added a note to the cart lesson

For details, see Working with carts.