Home>Items and inventory

Create and edit custom item attributes

Who is this article for?
  • Sellers with general items permissions. Set permissions in the Square Dashboard.
  • About custom attributes

    Custom attributes allow you to add and track additional information to your existing and new items. For example, a business that sells wine may want to store information such as vintage, origin, and tasting notes.

    Before you begin

    You can create custom attributes from the Square Dashboard on a laptop or desktop computer.

    Make sure you’ve created at least one item in your item library before assigning a custom attribute set to an item. Learn more about how to create and edit items with Square.

    Step 1. Create and edit custom attributes

    1. Sign in to your Square Dashboard and click Items & orders > Items > Custom attributes.

    2. Click Create custom attribute or select an existing custom attribute to edit.

    3. Enter the Attribute name and select the Attribute type (Text, Selection, Number, or Toggle).

    4. Click Add to create the custom attribute.

    Step 2. Add a custom attribute to an item

    Add a custom attribute to an item with no variation

    1. Sign in to your Square Dashboard and click Items & Orders > Items.
    2. Click on the selected item from the list.
    3. Click Add within the Custom attributes section.
    4. Select a custom attribute from the list and enter a value in the Value field > click Add.
    5. Click Save.

    Add a custom attribute to an item with variations

    1. Sign in to your Square Dashboard and click Items & Orders > Items.
    2. Click on the selected item from the list.
    3. Click on the name of your variation within the Variations section, an “Edit variation” window will pop up.
    4. Click Custom attributes > Add custom attribute.
    5. Select a custom attribute from the list and enter a value in the Value field > click Add.
    6. Click Done > Save.

    Add a custom attribute to a variation

    1. Sign in to your Square Dashboard and click Items & Orders > Items.
    2. Click on the selected item from the list.
    3. Click Edit variation details within the Variations section, an “Edit variation” window will pop up.
    4. Click Custom attributes > Add custom attribute.
    5. Select a custom attribute from the list and enter a value in the Value field > click Add.
    6. Click Done > Save.

    Remove a custom attribute

    Once you’ve assigned a custom attribute to an item, you can remove the custom attribute assigned to this item at any time.

    Remove a custom attribute from an item with no variation

    1. Sign in to your Square Dashboard and click Items & Orders > Items.
    2. Click on the selected item from the list.
    3. Click on the trash icon next to your custom attribute within the Custom attributes section.
    4. Click Save.

    Remove a custom attribute from an item with variations

    1. Sign in to your Square Dashboard and click Items & Orders > Items.
    2. Click on the selected item from the list.
    3. Click on the name of your variation within the Variations section, an “Edit variation” window will pop up > click Custom attributes.
    4. Click Custom attributes > Add custom attribute.
    5. Click on the x icon next to the name of your custom attribute > click Done.
    6. Click Save.

    Remove a custom attribute from a variation

    1. Sign in to your Square Dashboard and click Items & Orders > Items.
    2. Click on the selected item from the list.
    3. Click Edit variation details within the Variations section, an “Edit variation” window will pop up > click Custom attributes.
    4. Click on the x icon next to the name of your custom attribute > click Done.
    5. Click Save.

    Related articles