---
title: "addBasketView"
slug: "api/basket/operations/addbasketview"
sidebar:
  order: 524
---

<a id="ref-4961887b973a"></a>
<a id="ref-ccee206633bb"></a>
<a id="ref-db359597eda4"></a>

```text
BasketViewConfig addBasketView(SessionId sessionId,
    BasketViewConfig template)
throws BasketServiceFault;
```

See also: [`SessionId`](/pCon/configuratorOnline/specs/api/session/types/sessionid#ref-02e397c8fdb4), [BasketViewConfig](/pCon/configuratorOnline/specs/api/basket/types/basketviewconfig#ref-c93474937ff8), [`BasketServiceFault`](/pCon/configuratorOnline/specs/api/basket/faults/basketservicefault#ref-d5adb74faa1b)

The operation is used to add a new view to the basket. The basket view configuration passed as the `template` parameter contains the configuration options to be used for this view. The following default values are used for options that are not explicitly specified:

`viewId` randomly generated UUID

`displayMode` `Planning`

expandGroups	true

expandPlanningFolders	true

expandBasketFolders	false

expandPartialPlannings	false

expandAggregates	false

[`mergeMode`](/pCon/configuratorOnline/specs/api/basket/types/mergemode#ref-190f0820313d) `None`

autoColumnWidth	true

hiddenDiscounts	false

setArticleMode	Expand

`name` must be specified and must not be empty

`visibleColumns` the list of standard columns (position number, manufacturer, series, article number, description, quantity, single net price, total net price)

`columnWidths` empty

The operation returns the complete configuration of the newly added view.

The operation fails if

- - No non-empty name has been specified.

  - no valid view ID has been specified (invalid UUID or ID of already existent view)

  - the specified display mode is `Undefined`

  - the specification of visible columns is invalid (invalid UUID, non-existent column, duplicate columns)

  - the specified column widths are invalid (column ID does not specify visible column, column width less than or equal to zero, duplicate column widths)
