---
title: "computeArticleImageGroups"
slug: "api/basket/operations/computearticleimagegroups"
sidebar:
  order: 530
---

<a id="ref-1d5a2a1830d3"></a>
<a id="ref-eddaa0cd2eb6"></a>

## Synopsis

```text
ArticleImageGroup[] computeArticleImageGroups(
    SessionId sessionId, BItemId[] itemIds,
    ItemSelectionOptions? options) throws BasketServiceFault;
```

See also: [`ArticleImageGroup`](/pCon/configuratorOnline/specs/api/basket/types/articleimagegroup), [`SessionId`](/pCon/configuratorOnline/specs/api/session/types/sessionid), [`BItemId`](/pCon/configuratorOnline/specs/api/basket/types/bitemid), [`BasketServiceFault`](/pCon/configuratorOnline/specs/api/basket/faults/basketservicefault)

The computeArticleImageGroups operation computes groups of OFML article items that share the same article image. It supports setting images stored at basket level for specific article configurations. Images stored at item level, either by tag or in user-defined columns, are a separate mechanism.

There is no operation to set a basket-level article image directly. Instead, [setImages](/pCon/configuratorOnline/specs/api/basket/operations/setimages) with an empty tag sets the image for the specified OFML article item and all OFML article items with the same configuration or, under certain circumstances, the same geometry checksum.

If several items share the same configuration, the client needs to generate and set an image for only one member of each returned group. Setting the image for any item in the group effectively sets it for all members.

Only selected items are considered when computing groups. Selection is computed as usual from itemIds and [ItemSelectionOptions](/pCon/configuratorOnline/specs/api/basket/types/itemselectionoptions). To consider all OFML article items, pass an empty itemIds list; the selection options are then ignored entirely.
