System updates

We’re experiencing issues that may affect your Square services. We’ll continue to update our status page with more information.

Back to Home

Item Modifiers in Square Online

What Are Modifiers?

With item modifiers, you can sell items that are customizable or offer additional choices. These are different from item variations, such as size or colour, because they are not tied to your inventory levels and can be applied to any item.

There are two types of item modifiers: a text input box and a list of options. You can use modifiers with item variations to create products with a range of options for your customers to choose from. For example, if you’re selling an engravable bracelet that comes in multiple sizes. Your item variations would be the sizes (small, medium, large, etc.), and the modifier would be the custom text to engrave (the customer’s name or initials).


When a customer views your item page, they’ll see the modifiers and options you added and will be able to choose what they want before adding the item to the cart.

Create a List Type Modifier

When adding or editing an item in your online store, scroll down to the Modifiers section and click the Manage modifiers button. On the next screen, click Create New to create your first modifier.


Click the option to create a list of modifiers and give the list a name so customers know what they’re choosing. Enter each item (and an optional price adjustment) into the Choice field, and click Done after each entry.

You can also set up location-specific modifiers. This lets you offer the same item but with different modifiers depending on where it’s purchased from. Once your entries are completed, select the specific locations where this modifier will be available, or select Available at all future locations.

Note: Location-based modifiers are only available for list modifiers and not text box modifiers.

When you’re finished, click Save to return to the Manage modifiers page. On this page you’ll see any modifiers applied to the item as well as a list of all modifiers. Check the box next to a modifier to apply it to the item.

Create a Text Box Modifier

From your Square Online Overview page, click Items > Site Items. On your item page, select Manage Modifiers, click the Create new button and choose the text box option.

Note: You can also create text modifiers from your Square Item Library. Check out how to create and manage item modifiers for more information.


The text box modifier has only a few options:

Text Box Label, Character Limit, and an option to make the field required. The label text is what customers will see on the item page, so choose something that will make sense to them. Click Save when you’re done to go back to the Manage modifiers page.

Add Modifier Images

Note: Using modifier images requires an upgrade on your Square Online site.

By adding images to your modifiers, you can make online ordering for your customers much faster, easier, and more enticing. To add images to your modifiers in Square Online :

  1. From your Square Online Overview page, go to Items > Site Items.

  2. Select an item from your list or create a new one.

  3. Under Modifiers, select Manage modifiers.

  4. Select the button to create a new one or select “...” > Edit to change an existing one.

  5. Select the button to upload your own image or use one of our suggested images.

  6. Select Save when finished.

You can also add images to your modifiers from your Square Item Library in the Modifiers tab. Learn more about creating and managing item modifiers online from your Item Library.

Manage Modifiers

From the Edit Item page, click the Manage modifiers button to open the management page. You’ll see all of the modifiers you applied to this item here. All modifiers are available on the Manage modifiers screen whenever you edit or add an item, so you can quickly apply them to any item.


Use the checkboxes in the Apply Modifiers section to turn on or off individual modifiers for the current item. You can also edit, duplicate, or delete modifiers by clicking the “. . .” icon.

If you want to add more modifiers, click the Create New button and follow the steps outlined above.

Click the Done button to return to the Edit Item page.

Edit Modifier Settings


You can adjust the settings for list-type modifiers at the item level, meaning the changes will not affect any other items that have the same modifiers. Click the gear icon to access these settings.


You can adjust the following settings here:

Visibility: Check this box if you don’t want the modifier to show on receipts.
Number of Choices: Set a minimum and maximum number of choices. In this example, we don’t want the customer to choose more than one level of spiciness for their food, so the minimum and maximum are both set to one. If you change the maximum number to anything higher than one, the options display as checkboxes to allow multiple choices.
Make Default: Use the checkboxes to set a default option (or options). Options you check are preselected on the item page. Customers can choose a different option or leave the default choice.
Hide: Use the checkboxes to hide individual options if they aren’t available for this specific item.

Click Done when you’re finished to return to the Edit Item page. Save when you’re done editing to make the item modifiers available on your published website.

Mark Modifiers as Sold Out

When a modifier sells out, you can update its status to indicate such. This sold-out status will be reflected on your online store, thus maximizing omnichannel sales based on available inventory while minimizing accidental oversells. Other channels in which this status may appear include Square Restaurants Point of Sale (POS), online Dashboard, Square POS app and online Checkout Links.

From your online Dashboard:

  1. Go to Modifiers in your online Square Dashboard, and click the modifier set you’d like to mark as sold out.

  2. Toggle off the Available status and click Save. Note: If you have more than one active location on your Square account, you will be prompted to select the location(s) in which you want to mark the modifier as sold out.

From the Square app:

  1. Tap More from the navigation bar at the bottom of your screen and select Items.

  2. Tap Modifiers and select the modifier that you want to mark as sold out.

  3. Toggle off the Available status. Note: If you have more than one active location on your Square account, you will be prompted to select the location(s) in which you want to mark the modifier as sold out.

Can't find what you need?