--- title: Attributes slug: user-documentation/attributes docTags: createdAt: 2024-05-02T12:35:58.357Z --- Attributes are fundamental in organizing and enriching product data, enabling efficient management and seamless customer experiences. This guide will walk you through the step-by-step process of creating attributes in the PIM system. From defining the attributes' properties to configuring their display options, we’ll cover everything you need to know to tailor your product data to your specific needs. :::hint{type="info"} To learn more about Attributes, go to the [Key Concepts](docId\:EkaoYvEHv6fzY3EGa_ZMC). ::: ## Step 1: Access Attributes Log in to the UpStart Commerce Portal. Navigate to the side menu, select **PIM**, and then choose **Attribute**. ![](https://api.archbee.com/api/optimize/Yc_G-eLlbuN1stqxAdHsJ/Nb764d7bmAM5AH3zL_RA4_redacted-image-7.png) ## Step 2: View Existing Attributes The Attribute List View in the portal, showcases: - **Attribute ID and Name:** For quick identification and reference. - **Status:** Indicates whether the attribute is Enabled, Disabled, or in Draft. - **Scope:** Displays if the attribute is at the Product, Variant, or Overridable level. - **Last Updated:** Tracks when the attribute was last modified for easy monitoring. - **Associated Templates:** Shows which product templates use the attribute. At the top of the list, a dropdown filter is visible, allowing you to refine your search efficiently. You can filter attributes based on: - **Status (Enabled, Disabled, Draft)** - **Scope (Product, Variant, Overridable)** - **Last Updated (date ranges)** - **Associated Templates** Using these filters helps narrow down your attribute list, making it easier to locate and manage specific attributes within large catalogs. By clicking an Attribute ID or Name, a details panel opens on the right, enabling you to view, edit, or audit attribute information to maintain consistency across your product data management workflow. ![](https://api.archbee.com/api/optimize/Yc_G-eLlbuN1stqxAdHsJ/Rv1W3TbNuUI29zjvDaXst_redacted-image-8.png) Click on the **Attribute ID** to view the details of the existing attribute. Once clicked, a side window will appear on the right side of the screen. Here, you can view all the details related to the attribute, along with the associated product templates. To see the full details, click on **Open**. If you need to modify any of the existing attribute details, click on **Edit**. ![](https://api.archbee.com/api/optimize/Yc_G-eLlbuN1stqxAdHsJ/JPOiD3u5BEK5P7eObzqqr_redacted-image-9.png) **Applying Filters for Efficient Data Search: **To streamline data management, you can quickly filter information by selecting your desired fields. For example, you can filter by **Status**,** Last updated**, **Scope,** etc using the dropdown menus to refine your search effectively. :::hint{type="info"} To learn more about Filters, go to the [PIM Filters](docId\:feALiQFdiyqtvARyr2VfI) guide. ::: ## Step 3: Create and Define Attribute Details To create a new attribute, click the **Create Attribute** button located at the top-right corner. Once you've initiated the process, add the following essential details: 1. **Attribute Name:** Enter the **Attribute Name** that describes the attribute you are creating. 2. **Code Friendly Name:** Specify a **Code Friendly Name** for the attribute, ensuring it is easily identifiable and usable in a programming context. By default, it will be set to the Attribute Name entered. 3. **Attribute Type:** Choose the appropriate **Attribute Type** from the list of available options, based on the type of data the attribute will be storing. :::hint{type="info"} For detailed information on **types of attributes**, refer to the [Attribute Data Types](docId:2KufgitSSfWyWk_3CVvyK) guide. ::: ::Image[]{src="https://api.archbee.com/api/optimize/Yc_G-eLlbuN1stqxAdHsJ/0Xu_xb3JegMpWaPwqsOzE_image.png" size="72" width="980" height="782" position="center" showCaption="false"} :::hint{type="warning"} **Note:** Below is a table explaining the states and their corresponding statuses in PIM, along with whether the products are **Purchasable** and **Available** in the Catalog: ::: | ** State** | ** Status** | ** Purchasable** | ** Available in Catalog** | | ---------------------- | ---------------------- | --------------------- | ----------------------------------- | | **Normal** | Published | True | Yes | | **View Only** | Published | False | Yes | | **Hidden** | Published | True | Yes | | **Archived** | Published | False | No | ## Step 4: Finalizing Attribute Creation After completing the form, you are presented with two choices: 1. **Create Draft:** Click on the **Create Draft **button to save your attribute as a draft, keeping it unpublished on the portal. This allows you to revisit and edit the attribute details at your convenience before publishing it for user visibility. 2. **Create & Open:** Click on the **Create & Open** button, and you will be directed to the **Attribute Detail **page. This is the preferred choice when you intend to make the attribute live and immediately utilize it on the UpStart Commerce Portal. ::Image[]{src="https://api.archbee.com/api/optimize/Yc_G-eLlbuN1stqxAdHsJ/lG9g4CHlcLhXUvgIAf2s5_image.png" size="80" width="977" height="782" position="center" showCaption="false"} ## Step 5: Configure Attribute Details 1\. On the **Attribute Detail Page**, configure attribute details by selecting the scope level for your product: 1. **Product: **If you set the attribute scope level to** Product**, the attribute will be added as a product characteristic. This means that the attribute will apply to all products within the system. 2. **Variant:** If you set the attribute scope level to **Variant**, the attribute will be added as a variant characteristic. This means that the attribute will only apply to specific variants of products. 3. **Overridable:** Setting the attribute scope level to** Overridable** allows the attribute to be overridden for both product and variant. This means that the attribute can be customized at both the product and variant levels, providing flexibility in attribute management. :::hint{type="success"} **Note**: Attributes scoped to “Variant” can also be **edited **or **removed **in bulk during draft management of variants, ensuring consistency and efficiency during large catalog updates. ::: 2\. Add a **Description** for your attribute. This description should help others understand its use and relevance. ::Image[]{src="https://api.archbee.com/api/optimize/Yc_G-eLlbuN1stqxAdHsJ/goh3QLiB7lT5cXzoxL1fH_image.png" size="86" width="1151" height="477" position="center" showCaption="false"} **3. Attribute Input: **Enable the **Required** toggle if the attribute input type needs to be defined. Choose the appropriate **Input Type** from the dropdown menu, which specifies how the attribute values will be captured (e.g., text, radio buttons, password, month, etc.). Additionally, you can define specific options for the selected input type to ensure accurate data collection in the desired format. **4. Multivalued:** Enable the toggle to **Yes** to allow the attribute to accept and manage multiple values, offering greater flexibility for the product dataset. Additionally, specify the **Minimum Inclusive Value** and **Maximum Inclusive Value** for the attribute. You can further refine the attribute's configuration by defining a multiplier in the provided box labeled **Multiply Of**. ::Image[]{src="https://api.archbee.com/api/optimize/Yc_G-eLlbuN1stqxAdHsJ/bkUdTQ_GUZb00Bg2mP5Kq_image.png" size="78" width="1087" height="497" position="center" showCaption="false"} :::hint{type="success"} **Note: **All changes made in the PIM system are automatically saved. Once you have completed entering the necessary details, click the **Publish **button at the end to make **ALL CHANGES LIVE. ** ::: ## Step 6: Portal Display Configurations In the **Portal Display Configuration** section, add the following details: - **Display Group:** Select a **Display Group** where you want to place your attribute. Display groups help organize related attributes on the portal interface. - **Store Front:** Specify how you want the attribute to be displayed on the store front. Add a **Label**, set a **Priority**, and include any relevant **Helper Text** as needed. ::Image[]{src="https://api.archbee.com/api/optimize/Yc_G-eLlbuN1stqxAdHsJ/6aXbye5j4hB2f1-fMZpao_image.png" size="56" width="411" height="417" position="center" showCaption="false"} :::hint{type="success"} **Note**: Attributes not assigned to any Display Group or Section will be automatically removed from the storefront configuration during template or product finalization to maintain clean data structures. ::: ## Step 7: Search Configurations In this step, you will configure the search settings for your attribute according to your specific requirements. For **Indexed Search**, turn the toggle to **Yes** if you want your attribute to be searchable within the UpStart Commerce domain. For **Misspelling Support**, enable the toggle to allow detection and correction of any misspellings related to the attribute. This ensures accurate search results and improves the user experience. ![](https://api.archbee.com/api/optimize/Yc_G-eLlbuN1stqxAdHsJ/vYz8Jly56Lr58h60xtQQG_image.png) ## Step 8: Publish Attribute After adding all the attribute details, scroll up to **Publish** the attribute. You can also view and modify the status of your attribute by toggling between Enabled and Disabled. When **ENABLED**, the attribute is active and can be used; when **DISABLED**, it cannot be used further. Additionally, at the top, you will see the version, date, and time of the created attribute. Short Window appearing at the bottom-right, shows a preview of how your created attribute will be displayed in the storefront. ::Image[ Adding this SC here in case you want to add content for it as well.]{src="https://api.archbee.com/api/optimize/Yc_G-eLlbuN1stqxAdHsJ/Wva3DQkVCZh1JRR6NkGpV_image.png" size="64" width="571" height="300" position="center" showCaption="false"} :::hint{type="info"} **Note:** In PIM, changes are auto-saved, meaning any edits you make to a Published entity will automatically move it to the **Edits in Published **state. This indicates that a draft or changes exist that need to be published. Your published version remains unchanged until you publish the draft. Whenever needed, you can **PUBLISH** the edits to ensure your updates are reflected across the PIM system. ::: :::hint{type="danger"} **NOTE: **When you edit and publish an **ATTRIBUTE** or **ATTRIBUTE** **GROUP,** any changes you make are automatically **UPDATED** across **PRODUCT TEMPLATES **where they are used. This ensures consistency and accuracy in your product data, eliminating the need for manual updates to individual templates ::: ::Image[]{src="https://api.archbee.com/api/optimize/Yc_G-eLlbuN1stqxAdHsJ/z34vq9I1JR1xNBs_fVXNF_image.png" size="50" width="373" height="86" position="center" showCaption="false"} :::hint{type="info"} For detailed information on creating and configuring Attribute Groups, go to the [Attribute Groups](docId\:DkkW8yeF2ufXyOFvgeaAr) Guide. :::