Skip to content

How to Enable Custom Notes for Orders

The Orders Custom Fields feature allows your customers to include additional details or special instructions when placing an order. Whether they want to specify delivery preferences, packaging requirements, or custom product details, this feature ensures clear communication between you and your buyers, making every order more personalized and accurate.

This is especially useful for B2B and wholesale stores, where orders often come with specific demands such as custom labeling, bulk delivery notes, or internal reference numbers.

  1. From your Shopify admin, go to Apps → BSS B2B Solution.
  2. Go to B2B orders & discounts > Orders Custom Fields.

Orders Custom Fields page with the module off


Step 2: Enable the Module & Install the App Block

Section titled “Step 2: Enable the Module & Install the App Block”
  1. Click Turn on module in the Turn on the Orders Custom Fields module card, or use the switch next to the title. This makes the app block available to your theme.

  2. In Order custom fields in your theme, click Add app block. You can also open app block setup on the same page: pick your theme, click Check compatibility, then click Enable button on cart page. The app opens the Shopify Theme Editor on your cart template with the BSS Custom Fields block added.

    Orders Custom Fields page with the module on

  3. If your theme does not support app blocks, the Manual Installation card gives you ready-to-copy Liquid snippets: one per field type, to paste into your cart template (cart-template, cart-drawer, or ajax-cart-template).


Step 3: Configure the Field in the Theme Editor

Section titled “Step 3: Configure the Field in the Theme Editor”

Add the BSS Custom Fields block to your cart template, then set:

Setting Default What it does
Field name (saved on the order) bss-cart-note The name your team sees next to the customer’s answer on the order. Give each field a short, different name such as po-number.
Title “Add a note to your order” The label shown above the field.
Options option 1, option 2, option 3 Comma-separated choices, used by the radio, checkbox and dropdown types.
Title color #000000 Title text color.
Field type Text field Choose one of Text field, Radio button, Checkbox, or Dropdown list.

Theme editor settings for the BSS Custom Fields block

Need more than one field? Add multiple blocks, each with its own type and Field name (saved on the order).


Once a customer fills a field and places the order, the values are attached to the order as order attributes: one per field, keyed by the Field name (saved on the order) you set in the Theme Editor.

  • Find them in Shopify admin on the order’s Additional details section.
  • They are also available to third-party apps and order printers.
  • When a customer fills in a field, the order goes through the app’s checkout, the same one used for B2B prices, so the values can be attached.

If your customers often request special packaging or delivery timing, they can now simply write those details when placing an order, e.g., “Please deliver between 9 AM – 11 AM,” or “Pack in separate boxes by product type.”

This eliminates back-and-forth communication after checkout and ensures every order is handled exactly as your customer expects.


  • Better Communication: Capture customer preferences directly during checkout.
  • Customizable Field: Adapt the field title to fit your business process.
  • Smoother Fulfillment: Ensure your team has all the necessary details to prepare orders correctly.
  • Enhanced Customer Experience: Show professionalism by letting customers share their specific needs easily.

With Orders Custom Fields, your customers feel heard and supported, while your team gets the clarity it needs to deliver the perfect order every time.

Cart page with two custom fields: a Purchase order (PO) number text field and a Delivery preference dropdown