---
title: "SetArticleMode"
slug: "api/basket/types/setarticlemode"
sidebar:
  order: 332
---

<a id="ref-dca2014622b8"></a>
<a id="ref-fac3e2b995e7"></a>
<a id="ref-e8cb4160040b"></a>

## Synopsis

```text
enum SetArticleMode {
    Expand,
    Collapse,
    Dynamic,
    BreakUp
}
```

The view configuration option `setArticleMode` controls the view’s handling of set-article parts. It is honored in all view display modes.

**Expand**

Set-article parts are always visible.

**Collapse**

Set-article parts are never visible.

**Dynamic**

Set-article parts are hidden if and only if the set-article item is collapsed.[^1]

**`BreakUp`**

If field `setArticleMode` of type [`BasketViewConfig`](/pCon/configuratorOnline/specs/api/basket/types/basketviewconfig) is set to BreakUp, set-articles themselves are represented by the view as ordinary folder view items, and the article view items representing set-article parts report the quantity as the product of the set-article quantity and the quantity of the underlying basket article (affects operations [`getItemProperties`](/pCon/configuratorOnline/specs/api/basket/operations/getitemproperties), [getPriceCalculationSheet](/pCon/configuratorOnline/specs/api/basket/operations/getpricecalculationsheet), and [`getPriceCalculationSheets`](/pCon/configuratorOnline/specs/api/basket/operations/getpricecalculationsheets)).

The mode is supported for display modes `Sorted` and Planning. In sorted views, expansion of basket folders (expandBasketFolders of type [BasketViewConfig](/pCon/configuratorOnline/specs/api/basket/types/basketviewconfig)) also affects broken-up set-articles, which may, with the proper merge mode, result in the merging of set-article parts and non-parts into a single view item.

Note that changes to a view's set-article mode reconstructs the entire view, resulting in a complete new set of view item IDs.

[^1]: The ‘collapsed’ state of set-articles can be queried with operation `getItemProperties` (property setArticle.collapsed). It can be modified with operations `expandSetArticles` and `collapseSetArticles`.
