--- title: "Update product quantity on line items" slug: "configure-quantity-settings-for-bom-items" description: "Learn how to configure quantity settings for BOM items in Zilliant CPQ." updated: 2024-06-12T21:08:45Z published: 2024-06-12T21:08:45Z canonical: "docs.zilliant.com/configure-quantity-settings-for-bom-items" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.zilliant.com/llms.txt > Use this file to discover all available pages before exploring further. # Configure quantity settings for BOM items Learn how to: - [Configure quantity settings for bill of material items](/docs/configure-quantity-settings-for-BOM-items#configure-quantity-settings-for-bom-items) - Work with the [Quantity Update dialog](/docs/configure-quantity-settings-for-BOM-items#quantity-update-dialog) ## Configure quantity settings for BOM items Configure how Zilliant CPQ calculates the quantity of [bill of material (BOM)](/docs/define-product-bom) items on quote [sublines](/docs/manage-line-items#add-a-subline-item) and whether users can manually change the BOM items quantity in quotes. To configure quantity settings for BOM items, follow these steps: 1. From the application left navigation bar, select **Products**. 2. Select a product to open its settings. 3. On the **Product BOM** tab, configure how to update the BOM item quantity in quotes: - **Quantity factor**—Define how many times this product is added per unit of measure (UOM) of the parent product in the sales BOM. - **Quantity changes in relative with parent**—Set to **YES** if the BOM item requires a multiple quantity based on the quantity of the parent product. By default, this setting makes the quantity field on the quote subline read-only, but you can change this by using the **Quantity updateable by user** switch. - **Quantity updateable by user**—Set to **YES** to allow users to edit the quantity of the BOM item on the quote subline. - **Quantity updateable by Script**—Set to **YES** to control the BOM item quantity through the Groovy script or IMC script. To allow users to manually edit the quantity of the BOM item on the quote subline, use the **Quantity updateable by user** switch. For details, read [Update BOM items quantity through the script](/docs/configure-quantity-settings-for-BOM-items#update-bom-items-quantity-through-the-script). Depending on these settings, Zilliant CPQ may display a dialog to confirm the BOM item quantity updates after a user edits the parent product quantity on a quote line item. For details, read [Quantity Update dialog](/docs/configure-quantity-settings-for-BOM-items#quantity-update-dialog). ### Update BOM items quantity through a script #### IMCScript The following example [IMCScript](/docs/about-imcscript) is triggered by the **After update sales item** event. It uses a configured characteristics-based batch quantity and multiplies it by the parent product's quantity. ![Bill of material quantity update - IMC script](https://cdn.document360.io/24f960e8-3c1c-4c18-a2c6-83b6ae4aab84/Images/Documentation/Bill%20of%20material%20quantity%20update%20-%20IMC%20script.png?sv=2026-02-06&spr=https&st=2026-11-11T12%3A20%3A56Z&se=2026-11-11T13%3A20%3A56Z&sr=c&sp=r&sig=wl%2Fvec0Y10ErzT0H9cN8L8M7zP6Jw3RJNf6T3hVfMs8%3D) #### Groovy script [Groovy script](/docs/about-groovy) enables you to control whether users can edit the BOM item quantity on a quote subline and whether the BOM item appears in the **Quantity Update** dialog. Use the following parameters to configure the desired behavior: - **Schema.quantityUpdatableViaScript**—When set to true, the BOM item doesn't appear in the **Quantity Update** dialog. - **Schema.quantityNotUpdatableByUser**—When set to true, the BOM item quantity on a subline is not editable. Use the following table to understand how the parameters affect the behavior of the BOM item. | Schema.quantity UpdatableViaScript | Schema.quantity NotUpdatableByUser | Users can edit the BOM item quantity | BOM item appears in the **Quantity Update** dialog | | --- | --- | --- | --- | | True | True | No | No | | False | True | No | No | | True | False | Yes | No | | False | False | Yes | Yes | The following image shows an example Groovy script: ![Bill of material quantity update - Groovy script](https://cdn.document360.io/24f960e8-3c1c-4c18-a2c6-83b6ae4aab84/Images/Documentation/Bill%20of%20material%20quantity%20update%20-%20Groovy%20script.png?sv=2026-02-06&spr=https&st=2026-11-11T12%3A20%3A56Z&se=2026-11-11T13%3A20%3A56Z&sr=c&sp=r&sig=wl%2Fvec0Y10ErzT0H9cN8L8M7zP6Jw3RJNf6T3hVfMs8%3D) ## Quantity Update dialog After a user edits the parent product quantity on a quote [line item](/docs/manage-line-items), Zilliant CPQ can show the **Quantity Update** dialog to confirm the quantity update for the sublines. The dialog appears in these two cases: - In the parent product [BOM settings](/docs/configure-quantity-settings-for-BOM-items#configure-quantity-settings-for-bom-items), you set the **Quantity updateable by user** and **Quantity changes in relative with parent** switches to **YES**. - You added sublines manually. On the **Quantity Update** dialog, you can accept the proposed quantity for the sublines, keep the current quantity, or manually define the needed quantity. Each update of the subline quantity is recursively applied to the sublines of the next child level. Note In the LO-VC based architecture (SSC integration), the quote sublines quantity is always editable regardless of the product BOM settings. However, Zilliant CPQ displays a simple quantity confirmation dialog that enables you only to confirm or reject the sublines' quantity update.