The line-item-customization action facilitates a deeper interaction with products, particularly where choices reflect significant differences in features or commitments, such as different levels of service in subscription models. This not only improves the customer experience but also helps businesses effectively showcase the range and depth of their offerings.

A user's selection experience can be enhanced with richer descriptions/images as well as a simpler interface. No need to modify quantity, instead just make your choice of a single item.

line-item action and line-item-customization action are made to work together to create a great experience while maintaining the need for detailed invoicing and reconciliation.

Related Actions

This action pairs well with the following actions:

line-item

State

The selected option will be made available within the state. This is done redundantly as this will also be available within the unioned line-item action.

Union (required)

This action requires a line-item action as its target union.

Macro level details for how union attribute behaves can be found within the Union documentation.

Features

Name	Type	Description	Rules
selectionVariant	string	selectionVariant will be used to more control on layout on GUI side. Based on the requirement of business you can decide layout of line-item and define information that will be more relevant to defined selectionVariant. For example , with 'card' selectionVariant you will be able to see title and description in card layout form. Examples: "selection", "media", "card", "card-with-image".	Possible values: `selection`, `media`, `card`, `card-with-image`, `tabbed`.
selectionBehavior	string	selectionBehavior will have control on transition effect visibility when customer would select line-item on GUI side.	Possible values: `hidden`, `shown`.

Context (required)

Name	Type	Description	Rules
name	string	(required) A unique id within the context of the unioned line-items actions. Examples: "sku-12345".	MaxLength: 256 MinLength: 1
recommended	number	The index of the recommended option so that a user has a choice already made, rather than making a choice to progress. Examples: 10.
options	array	(required) The options to present to the customer.

Example

Below is an example payload for adding an Line-item-customization action to a business process or blueprint.

{
    "type": "line-item-customization",
    "union": 1,
    "context": {
        "name": "sku-12345",
        "recommended": 10
    },
    "features": {
        "selectionVariant": "card-with-image"
    }
}