Skip to main content

List From Carousel Node

The ListFromCarouselNode takes a group of items you've collected using a Carousel and shows them in a table format. You can:

  • Edit any item
  • Delete items
  • Undo a deletion
  • Add new items to the list

Use Case​

Use this node if you need to display items from carousel.

UI Examples​

Node in TellUs

Behavior​

The node works together with the ContainerNode. First, you need to create the desired logic in a separate file that you want to reuse. Then, add a carousel node and set the File embedded property to link it to your separate file. After that, use the Carousel Node within the List from carousel Node to display the item list to the customer by setting the Carousel variable to the appropriate carousel.

How to display item list columns and rows:

In TellUs - use the Items (TellUs) table definition field under Properties, to create a dynamic table definition. This is a Json object and the easiest way to build it is by using Data source composer (linked under the table definition field in the editor).

In the Data composer you can

  • Choose column names

  • Map values to rows

  • Decide whether a column should be summable

  • Set the data type of each column.

  • In Webchat - use the Items - field under Properties to map up to three columns to specific variables from the container. These will be displayed in the item list table.

Node Metadata​

PropertyDescription
Node classListFromCarouselNode
MessageType23
CanBeEditedTrue
CanBeProcessedOnceFalse
RequireUserResponseYes

Input Properties​

PropertyDescription
carouselNodeName

Variable name of carousel node (without brackets).

column1

Variable name of node (with brackets) that you want to display in first column (only Webchat).

column2

(Optional) Variable name of node (with brackets) that you want to display in second column (only Webchat).

column3

(Optional) Variable name of node (with brackets) that you want to display in third column (only Webchat).

tableDefinition

Json object of table structure, generated by Data composer.

noItemsInListMessage

Error message displayed when no items are added to itemlist.

  • Default Values:
      • En:There are no items in the list
      • No:Listen er tom
      • Dk:Listen er tom
      • Fi:Lista on tyhjä
      • Se:Listan är tom
removeButtonText

Text for button that deletes added item in item list.

  • Default Values:
      • En:Delete
      • No:Fjerne
      • Dk:Fjern
      • Fi:Poista
      • Se:Ta bort
undoRemoveButtonText

Text for button that undo delete action of item.

  • Default Values:
      • En:Undo
      • No:Angre
      • Dk:Fortryd
      • Fi:Kumoa
      • Se:Ångra
addNewButtonText

Name of the button that user click to add more items to itemlist (only in TellUs).

  • Default Values:
      • En:Add item
      • No:Legg til element
      • Dk:Tilføj element
      • Fi:Lisää tavara
      • Se:Lägg till vara
minItemCount

Minimal count of items customer needs to add.

  • Default Values:
      • En:1
maxItemCount

Maximal count of items customer can add.

minCountErrorMessage

Error message when customer hasn't added minimal count of items and tries to continue the flow.

  • Default Values:
      • En:There must be at least {0} item(s)
      • No:Det må være minst {0} ting i listen
      • Dk:Der skal mindst være {0} ting på listen
      • Fi:Listalla on oltava vähintään {0} rivi
      • Se:Det måste finnas minst {0} saker i listan
maxCountErrorMessage

Error message when customer has exceeded maximal count of items and tries to continue the flow.

  • Default Values:
      • En:There must be no more than {0} item(s)
      • No:Det kan ikke være mer enn {0} i listen
      • Dk:Der må ikke være flere end {0} ting på listen
      • Fi:Yhdellä hakemuksella pystyy ilmoittamaan enintään {0} riviä
      • Se:Det får inte va fler saker än {0} i listan
sumVariableName

Name of the variable of the carousel which needs to be summarized and added to output data (optional)

addItemButtons

Name of the button that user click to add more items to itemlist (only in Webchat).

continueButtons

Name of continue button (only in TellUs).

showTotalSum

Indicator to show or hide total sum at the end of item list. (optional)

  • Default Values:
      • En:false
  • Allowed Values:
      • true
      • false
totalSumLabel

Lable for total sum (optional).

  • Default Values:
      • En:Total Sum
      • No:Total sum
      • Dk:Samlet sum
      • Fi:Yhteensä
      • Se:Total summa
totalSumUnits

Units in which total sum is calculated that will be placed at the end of total sum value (e.g. currency sign).

defaultValidationMessage

The default error message shown when the input is invalid or missing. This is used if no custom validation message is provided.

  • Default Values:
      • En:Please type in value
      • No:Skriv noe
      • Dk:Indtast værdi
      • Fi:Kirjoita kenttään
      • Se:Ange värde
sectionId

Groups this node visually under a specific section in TellUs. When multiple nodes share the same sectionId, they are displayed together under a shared header.

defaultValue

The initial value that is prefilled into the input field when the node is rendered. Useful for suggesting defaults or pre-populating known data.

isRequired

Determines whether the user must provide a value before continuing. If set to true, the form will not proceed without input.

  • Default Values:
      • En:true
  • Allowed Values:
      • true
      • false
isRequiredValidationMessage

The error message shown when a required field is left empty. This overrides the default validation message when isRequired is true.

  • Default Values:
      • En:Value is required
      • No:Verdi er påkrevd
      • Dk:Værdi er påkrævet
      • Fi:Arvo vaaditaan
      • Se:Värde krävs

Output Properties​

PropertyDescription
Sum

Total sum value.

  • Possible Outputs: Calculates the sum of variable values in list items. Variable name is specified in sumVariableName
Count

Count of item list items.

  • Possible Outputs: Get count of list items
displayValue

Json object of table definition and values, used in Overview (only in TellUs).

Editor Example​

Try it in the Atlas Editor for TellUs Try it in the Atlas Editor for Webchat

This link opens a prebuilt flow using this node in context. You can inspect how it's configured, how it's connected, and how it behaves in a real editor environment.

Editor example