> This page is for Developer.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.bigcommerce.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.bigcommerce.com/_mcp/server.

## 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](/developer/api-reference/rest/admin/management/carts/carts-single/create-cart) and [Add Cart Line Items](/developer/api-reference/rest/admin/management/carts/items/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](/developer/docs/storefront/headless/cart-and-checkout/carts) page
* **Checkout & Orders REST API course** — added a note to the cart lesson

For details, see [Working with carts](/developer/docs/storefront/headless/cart-and-checkout/carts).