Agreement line items store information about products to which you apply special prices and discounts. Line items appear on the Line Items tab in agreements.
Learn how to work with line items:
Additionally, your admin can:
Add a line item
You can add a line item:
From the product catalog
On the Line Items tab, above the list of line items, select Add > + Add Line Item to open the product catalog.
Use one of the following ways to add products:
Select a checkbox next to the name of one or multiple products. Then select Add and Close to add products as line items and close the product catalog.
Select a checkbox next to the name of one or multiple products. Then select Add to add products as line items. The product catalog remains open.
Select a product to view its details. Enter the product quantity, then select Add.
Through quick add
On the Line Items tab, above the list of line items, select Add.
In the Search by product name or ID field, begin typing a product name or ID.
On the product, select + Add.
From an agreement
To copy a line item and its configurations from another agreement, follow these steps:
On the Line Items tab, above the list of line items, select Add > Copy from Other Agreements.
Select one or more agreements, then select View Line Items.
Select one or more line items, then select Add.
Through guided selling
Guided selling helps you find the right products for your agreement by asking a series of relevant questions.
To add line items using guided selling:
On the Line Items tab, above the list of line items, select Add > Add Items from Guided Selling.
Select a question set and start answering questions. Your answers appear on the right side of the page. You can return to any question and change your answer. After you answer the final question, a customized product catalog appears.
Use one of the following ways to add products:
Select a checkbox next to the name of one or multiple products. Then select Add to add products as line items. The product catalog remains open. Select Close to exit the catalog or Start Over to add more products.
On a product, select Add and Close to add the product as a line item and exit the catalog.
Add a subline item
To add a line item as a subcategory of another line item, follow these steps:
On the Line Items tab, select a checkbox next to the position number of a line item to which you want to add a subcategory.
Add a line item. It will appear as a subcategory of the line item that you've selected in Step 2.
Add a product bundle
On the Line Items tab, above the list of line items, select Add > Add Product Bundles.
Select one or multiple product bundles, then select Add.
Note
By default, you cannot change the quantity of items added through a product bundle after the bundle is added. However, your administrator can enable quantity updates for those items.
Substitute a product on a line item
On the Line Items tab, select a checkbox next to the position number of one or multiple line items.
Above the list of line items, select View Product Substitutions.
Select products, then select Apply Substitutions.
Copy a line item
On the Line Items tab, select a checkbox next to the position number of one or multiple line items.
Above the list of line items, select Copy Line Item.
Copied line items appear at the end of the list.
Rearrange line items
Add selected lines as subcategories of another line item
On the Line Items tab, select a checkbox next to the position number of the line items you want to move.
Locate the target parent line item and right-click it.
In the context menu, select Shift line item(s) > Shift to this line item.
Display selected lines as individual line items
On the Line Items tab, right-click a subline item.
In the context menu, select Shift line item(s) > Shift to Agreement level.
Make a mass update of line items
Note
Mass update of line items automatically triggers the After Update Sales Item IMCScript group to ensure consistency in automation and downstream processes.
On the Line Items tab, select a checkbox next to the position number of the line items you want to edit.
Above the list of line items, select Mass update on selected line items.
Enter the needed values, then select Update.
Update line items with a script
If your administrator configured this function, you can run a script to automatically add products, configure them, set attributes, and perform other supported operations in an agreement. For details, read Organize Line Item Structure.
To update line items with a script:
On the Line Items tab, above the list of line items, select Update line items with a script.
On the Update line items with a script dialog, select a script, then select Next.
Preview the line items structure, then select Accept to apply the changes.
Note
The system doesn't run validation checks when generating the preview. This means that when you select Accept, the system might still encounter a problem if there are any conflicts.
View and manage line item details in the side panel
Apart from viewing all line items in a table, you can open a side panel to display detailed information about a specific line item. To open the side panel:
On the Line Items tab, select a line item position number. The side panel appears, allowing you to view and manage line item details.
The header of the side panel shows key line item data at a glance:
Line item name
Quantity
Net price
Net value
Total price
The side panel includes three tabs that organize line item details:
Overview—Displays general information about the line item, such as title, status, product name, ship-to ID, and other key attributes. This tab also includes pricing details, such as quantity, margin, and discount, and any additional data relevant to the line item.
Additionally, you can customize the layout of the Overview tab. For details, read Customize fields.
Price Items—Displays all price items linked to the selected line item. You can view and edit existing data points, create new manual price items, or delete previously added manual price items. For details, read Work with price items in Manage agreement pricing.
Additionally, you can customize the layout of the table on the Price Items tab. For details, read Customize columns.
Sales Item Text—Displays descriptive or supporting text associated with the line item, such as notes or additional information for internal or customer-facing use.
Additionally, you can customize the visibility and editability of sales item text options. For details, read Customize the Sales Item Text tab.
To close the side panel, in the top right corner, select X.
Delete a line item
On the Line Items tab, select a checkbox next to the position number of one or multiple line items.
Above the list of line items, select Delete Line Item. To confirm the action, select Yes.
Allow quantity updates for product bundle items
Before you begin
To allow quantity updates for product bundle item, verify that you have the ADMIN PERMISSION. For details on assigning permissions, read Role management.
Note
If you use both agreements management and quoting capabilities in Zilliant CPQ, this setting applies to product bundles in both agreements and quotes.
When users add line items through a product bundle, CPQ stores bundle details on those line items. By default, this prevents users and scripts from changing the quantity of bundle-added items after the bundle is created.
Use the Allow Quantity Update for Product Bundle Items setting to control this behavior:
When the setting is enabled, users and scripts can update the quantity of line items added through a product bundle.
When the setting is disabled, CPQ preserves the default behavior and prevents quantity updates for bundle-added items.
By default, the setting is disabled.
To configure the setting:
From the application left navigation area, select Administration.
From the top navigation bar, select Master Data Management.
Scroll or search to locate Setting Boolean and select it from the list.
In the Name column, select Allow Quantity Update for Product Bundle Items.
Set the Setting Value Boolean switch to YES to enable the setting or NO to disable it.
Select Save.
Control the execution of Groovy scripts linked to BDAs and BRAs
Before you begin
To control the execution of Groovy scripts, verify that you have the ADMIN PERMISSION. For details on assigning permissions, read Role management.
Note
If you use both agreements management and quoting capabilities in Zilliant CPQ, this setting applies to line item creation in both agreements and quotes.
Use the Skip execution of Groovy script links with BDA/BRA toggle in the Post Line Item Edition Groovy extension point to improve performance during line item creation.
When this setting is enabled, Zilliant CPQ does not run Groovy scripts linked to business data attributes (BDA) and business relation attributes (BRA) value-change events when creating line items. This helps reduce repeated script execution in operations that create or duplicate multiple line items.
This setting is useful when attribute-level Groovy scripts perform resource-intensive actions, such as external API calls, large calculations, or processing many attributes at once.
The setting applies to the following actions:
Create a new agreement version
To configure the setting:
From the application left navigation area, select Administration.
From the top navigation bar, select Master Data Management.
Scroll or search to locate Groovy Script and select it from the list.
In the Name column, select Post Line Item Addition.
Enable or disable the Skip execution of Groovy script links with BDA/BRA toggle.
Select Save.
Note
If you enable this setting, review any Groovy logic linked to BDA or BRA attributes. Instead of running multiple attribute-level scripts during line item creation, move the required logic to a Post Line Item Addition script where possible. This approach helps consolidate calculations and reduce repeated processing.
