Articles on: Advanced Capabilities

How to Activate and Use PuppetVendors Custom Sale Shopify POS Widget

This article describes how you can activate and use the PuppetVendors Custom Sale Shopify POS Widget.


Shopify's default Custom Sale assigns items to "N/A vendor" in PuppetVendors, requiring manual reassignment later. The PuppetVendors Custom Sale widget lets you assign the correct vendor at checkout — no portal, no laptop, no extra steps.



Article Content


  1. Requirements
  2. How to activate PuppetVendors Custom Sale Widget on Shopify POS
  3. How to use the widget to create a custom sale with vendor attribution
  4. How to activate PuppetVendors Custom Sale Widget on Shopify POS (video recording)


Requirements

  1. PuppetVendors installed on your Shopify store
  2. Shopify POS app (any plan — POS Pro not required)
  3. Works on iPad, iPhone, and Android


How to activate PuppetVendors Custom Sale Widget on Shopify POS


  1. In your Shopify POS home screen, tap on Add tile.
  2. Tap on Apps, then tap PuppetVendors
  3. Tap on the Add button to the right of the app row

Install Shopify POS PuppetVendors Custom Sale Tile


  1. You will then see a PuppetVendors Custom Sale tile on your home screen.

PuppetVendors Custom Sale Widget with Vendor Selector

  1. The custom sale creation process works exactly the same as it does with Shopify's default Custom Sale widget with the exception that the app's custom one comes with a vendor selector. Commissions set for each vendor are set directly within PuppetVendors. You also have the ability to create a new one on the fly.


How to use the Widget to create a custom sale with vendor attribution

  1. Tap the PuppetVendors Custom Sale tile on your POS home screen
  2. Enter item details: Item name (e.g., "Vintage Denim Jacket"), Price, Quantity (default: 1), Taxable (toggle on/off)
  3. Tap Select Vendor
  4. Search or scroll to find the vendor
  5. Tap the vendor name to select
  6. Tap Add to Cart

e item appears in your cart with the vendor assigned. Complete checkout as normal.


How to activate PuppetVendors Custom Sale Widget on Shopify POS (video recording)




FAQ


Q: Do I need Shopify POS Pro?

  • No. Works with any Shopify POS plan.


Q: What if I pick the wrong vendor?

  • Before checkout: remove from cart, re-add with correct vendor. After checkout: edit in PuppetVendors (Sales → click line item → edit vendor).


Q: Can I still use Shopify's default Custom Sale?

  • Yes. Both tiles can coexist.



Troubleshooting


**Widget not appearing? **

  • Update your Shopify POS app, or try removing and re-adding the tile.


"Failed to fetch vendors" error?



Questions or concerns setting this custom widget, reach out to support@puppetvendors.com







Updated on: 16/02/2026

Was this article helpful?

Share your feedback

Cancel

Thank you!