> For the complete documentation index, see [llms.txt](https://docs.xorosoft.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.xorosoft.com/xoroerp-1/manufacturing/bill-of-material/update-bom-items.md).

# Update BOM Items

### **Overview:**

The **Update BOM Items** module allows users to efficiently modify raw material details across **Bills of Materials (BOMs)** and **Manufacturing Orders (MOs)** from a single interface. It acts as a centralized workspace where users can search for specific items, update quantities, replace materials, and apply changes in bulk—without opening individual BOMs or MOs.

The module supports two update contexts—**Bill of Material** and **Manufacturing Order**—enabling users to control whether changes apply to product definitions (BOMs) or in-progress/created production records (MOs). This ensures flexibility in handling both design-level and execution-level updates.

### **Header Level Options**

The following options are available in the **Update BOM Items** module to perform bulk update actions:

* **Update Selected Records:**\
  Applies changes to the selected rows in the grid. This is useful when updates are required for specific BOMs or Manufacturing Orders.
* **Update All Records:**\
  Available within the **Update Selected Records** dropdown. This option applies changes to all records loaded in the grid based on the selected filters, enabling bulk updates without manually selecting each row.

### **Header Level Search Fields**

These fields help users filter and control which records are displayed for update:

| Field                                               | Description                                                                                                                                                                                                                                                                                                                                                                       |
| --------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Update Type**                                     | Allows users to choose between **Bill of Material** and **Manufacturing Order**, determining whether updates apply to BOM definitions or MOs.                                                                                                                                                                                                                                     |
| **Item Selection**                                  | Enables users to search and select a specific raw material item to filter relevant BOMs or MOs where the item is used. The dropdown also includes an **“Add New Item”** option, allowing users to create a new item directly without leaving the module.                                                                                                                          |
| **Revision Filter (All Revisions / Last Revision)** | This field is available only when the **Update Type** is **Bill of Material**. It allows users to filter BOMs based on revision level, ensuring updates are applied to the correct version. A **Settings (gear) icon** is also available, which provides additional controls such as **Apply to All** and **Remove from All** to manage how updates are applied across revisions. |
| **Active BOMs Toggle**                              | This field is also available only when the **Update Type** is **Bill of Material**. It filters records based on BOM status. When enabled, only active BOMs are displayed.                                                                                                                                                                                                         |

### **Header Level Icons**

These icons provide quick actions for managing and navigating records:

* **Navigation Controls:** Allow users to move across pages when handling large datasets.
* **Search:** Allows quick keyword-based searching within loaded records.
* **Refresh:** Reloads the data based on the current filters to reflect the most recent information.
* **Save:** Saves user-specific grid preferences such as column visibility and layout.
* **Download:** Exports the displayed data into formats like CSV or Excel for reporting and analysis.
* **Columns:** Allows users to customize the visible columns in the grid. The available columns dynamically adjust based on the selected **Update Type** (Bill of Material or Manufacturing Order), ensuring only relevant fields are displayed for the selected context.

#### **For Update Type: Bill of Material**

| Field                      | Description                                                                                    |
| -------------------------- | ---------------------------------------------------------------------------------------------- |
| **BOM Name**               | Displays the name of the Bill of Material.                                                     |
| **Replacement Item#**      | Allows users to select a replacement item for the raw material.                                |
| **Instruction Notes**      | Displays any instructions associated with the BOM item. Users can modify this field as needed. |
| **Revision**               | Indicates the BOM revision number.                                                             |
| **Item Number**            | Displays the raw material item used in the BOM.                                                |
| **Item Type**              | Specifies the type of item (Inventory, Non-Inventory, etc.).                                   |
| **Item Unit Cost**         | Displays and allows users to update the unit cost of the raw material item.                    |
| **Qty**                    | Displays and allows users to update the quantity of the raw material in the BOM.               |
| **Description**            | Displays and allows users to update the description of the raw material item.                  |
| **Is BOM Active**          | Indicates whether the BOM is active or inactive.                                               |
| **PARTS**                  | Displays and allows users to update the parts classification associated with the BOM item.     |
| **BOML-2 Multi line text** | Displays and allows users to update the custom multi-line text for additional BOM details.     |
| **BOML-3**                 | Displays and allows users to update this custom field for extended BOM-related information.    |
| **BOML-4-mlt**             | Displays and allows users to update this multi-line custom field for additional inputs.        |
| **Multi-Select List**      | Displays and allows users to select or update multiple predefined values for the BOM item.     |
| **Multi line text**        | Displays and allows users to update additional custom notes or descriptions.                   |

#### **For Update Type: Manufacturing Order**

| Field                      | Description                                                                                      |
| -------------------------- | ------------------------------------------------------------------------------------------------ |
| **MO#**                    | Displays the unique Manufacturing Order number.                                                  |
| **Batch MO#**              | Displays the batch reference number if the MO is part of a batch.                                |
| **Status**                 | Indicates the current status of the Manufacturing Order (e.g., Open, Released).                  |
| **Item Number**            | Displays the raw material item used in the Manufacturing Order.                                  |
| **Item Type**              | Specifies the type of item (Inventory, Non-Inventory, etc.).                                     |
| **Item Unit Cost**         | Displays and allows users to update the unit cost of the raw material item.                      |
| **Qty**                    | Displays and allows users to update the quantity of the raw material in the Manufacturing Order. |
| **Description**            | Displays and allows users to update the description of the raw material item.                    |
| **Is BOM Active**          | Indicates whether the associated BOM is active.                                                  |
| **Color**                  | Displays and allows users to update the color attribute of the item.                             |
| **Finish Multi Line Text** | Displays and allows users to update multi-line finish-related details.                           |
| **Mounting**               | Displays and allows users to update mounting-related attributes.                                 |
| **Grille**                 | Displays and allows users to update grille-related attributes.                                   |
| **Grille Color**           | Displays and allows users to update the grille color.                                            |
| **Multi line text**        | Displays and allows users to update additional custom text details.                              |
| **Feet**                   | Displays and allows users to update feet-related attributes.                                     |
| **Amplifier**              | Displays and allows users to update amplifier-related attributes.                                |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.xorosoft.com/xoroerp-1/manufacturing/bill-of-material/update-bom-items.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
