{"section":"tutorials","requestedLocale":"en","requestedSlug":"assembly-options-app","locale":"en","slug":"assembly-options-app","path":"docs/en/tutorials/apps/assembly-options-app.md","branch":"main","content":"> ⚠️ This app is only available for stores developed using [VTEX IO](https://vtex.com/br-pt/store-framework/). Before proceeding, you need to [install and configure Product Customizer](https://developers.vtex.com/vtex-developer-docs/docs/vtex-product-customizer) in your store.\n\nProduct customization options are available at VTEX when using [Assembly Options](/en/docs/tutorials/assembly-options). This solution helps create [attachments](/en/docs/tutorials/what-is-an-attachment) for complex scenarios in which you need to manage different product combinations, quantities, additional items and costs.\n\nAs an alternative to implementing Assembly Options through Catalog attachments, the [Assembly Options app](https://apps.vtex.com/vtex-admin-assembly-options/p) provides an interface to configure and manage customization options in stores using [VTEX IO](https://vtex.com/br-pt/store-framework/).\n\n## Installation \n\nYou can install the app for free from the [VTEX App Store](https://apps.vtex.com/vtex-admin-assembly-options/p) or via [VTEX IO CLI](https://developers.vtex.com/vtex-developer-docs/docs/vtex-io-documentation-vtex-io-cli-installation-and-command-reference) by following the steps in the [Assembly Options guide for developers](https://developers.vtex.com/vtex-developer-docs/docs/assembly-options-app).\n\n> ⚠️ If you install the Assembly Options app in a [seller account](/en/docs/tutorials/what-is-a-seller), the product customization options will be displayed to your customers at checkout. If you want the options to be displayed in the product page, you need to install the app in a [marketplace account](/en/docs/tutorials/what-is-a-marketplace).\n\nAfter installation, the **Catalog > Assembly Options** page will become available in the VTEX Admin. Below, you will find the app’s available features.\n\n## List of Assembly Options\n\nIn the VTEX Admin, go to **Catalog > Assembly Options** to access a list with all the assembly options available in your store.\n\n\n\nBelow, you will find the information displayed in the list:\n\n* **ID:** Shows the assembly option ID, which is the same as the [attachment](/en/docs/tutorials/what-is-an-attachment) ID in the **Catalog**.\n* **Name:** Indicates the name of the assembly option's attachment.\n* **Required:** If it is marked with a , this column indicates that the assembly option attachment is required. If this field is empty, no action is needed.\n* **Status:** It indicates the assembly option status, which can be either:\n * **Active**: It means that the customization options are active; therefore, they’ll appear in your store if they’re [associated with a SKU](/en/docs/tutorials/adding-an-attachment#associating-the-attachment-with-a-sku).\n * **Inactive**: The customization options are inactive; therefore, they cannot be chosen.\n* **Menu** : It shows the options available:\n * **Edit**: Provides access to the edit page of the assembly option.\n * **Delete**: Deletes an assembly option.\n\nUse the search field to look for an assembly option by name. You can also filter the results in the list by **Status** (**Active** or **Inactive**).\n\nTo set up a new assembly option, click the `Create assembly option` button in the upper right corner of the page.\n\n## Creating or Editing Assembly Options\n\nThe **Products > Assembly Options > New Assembly Options** page contains a form with all the information needed to create or edit an assembly option. Follow the steps below to create an assembly option.\n\n1. Fill in the **Basic information** fields:\n * **Name:** Name of the assembly option, e.g., Ingredients.\n * **Active:** Defines whether the assembly option will remain active, i. e., available to be used in the store.\n * **Required:** Defines whether it is necessary for your customers to choose one of the options available.\n2. In **SKU Groups**, click `Add new group`.\n A group with no name will be created. Each group will have the SKU options available for your customers to choose from.\n3. Fill in the information required to create the group:\n * **Name**: Name of the group that will be displayed on the product page, e.g., Extra ingredients.\n * **Minimum quantity:** Defines the lowest number of group items the customer can choose.\n * **Maximum quantity:** Defines the highest number of group items the customer can choose.\n4. Click `Add SKU` to add an existing SKU to the group.\n5. Complete the following information about the SKU:\n * **SKU ID:** SKU identifier.\n * **Linked price table name:** Name of the price table in which the chosen SKU is listed. If this field is empty, the SKU takes the price of the trade policy.\n * **Minimum quantity:** Lowest number of items that the customer can choose.\n * **Maximum quantity:** Highest number of items that the customer can choose.\n * **Initial quantity:** Quantity selected by default.\n6. Click `Add`.\n The information about the added SKU will be shown in a table, and you will be able to edit it or delete the SKU from the group.\n If necessary, you can add other SKUs to the group by repeating step 4 onwards. You can also create other groups by repeating step 2 onwards.\n7. Once all groups have been configured, click `Save`.\n\nWhen you save an assembly option, an attachment is automatically created in **Catalog > Attachments** with the prefix `vtex.assembly-option.` added to the name of the assembly option created. For example: `vtex.assembly-option.Ingredients`.\n\n> ⚠️ For the customization options created in **Assembly Options** to appear in the storefront, you will need to associate the attachment created with a SKU in **Catalog > Products and SKUs > Advanced settings > Attachments**. To do so, follow the steps described in [Associating the attachment with a SKU](/en/docs/tutorials/adding-an-attachment#associating-the-attachment-with-a-sku).\n\n## Learn more\n\n* [Assembly Options](/en/docs/tutorials/assembly-options)\n* [What is an Attachment?](/en/docs/tutorials/what-is-an-attachment)"}