Common questions about importing products, setting up filters, managing variants, and syncing data with SupplyMaster.
Filters & Product Selection
Where do I find and use the product filter option?
Go to View Products → Edit Filters. You can add product filters (e.g., Brand Name, Style Number, Category) and variant filters (e.g., Color Name, Size) to control exactly which items are imported.
After connecting my supplier, products appeared automatically. Can I control this?
Products may appear by default depending on your supplier configuration. Go to View Products → Edit Filters to include or exclude specific brands or products. Without filters, your supplier’s entire catalog may be imported. Always configure filters before enabling Auto Import.
How do I filter multiple brands at once?
Use the Contains Any condition. Add a product filter for Brand Name, set the condition to Contains Any, and enter your brands separated by commas (e.g., Sport-Tek, Nike, New Era). All products matching any of the listed brands will be included.
How do I exclude specific brands?
Use the Not Equal To Any condition. Add a product filter for Brand Name (or Mill, depending on your supplier), set the condition to Not Equal To Any, and enter the brands to exclude. All products except those brands will be included.
How do I import products by style number?
Add a product filter for Style Number (or Part Number), set the condition to Contains Any, and enter a comma-separated list of style IDs (e.g., PTS30, PTS20, 112P). This is more efficient than creating multiple separate filters.
How can I filter by specific colors or sizes?
Use variant filters. Go to Edit Filters, add a Variant Filter, and select the attribute (e.g., Color Name or Size Name). Set the condition to Equal To Any or Contains Any and enter your values. For example:
Size Name — Equal To Any —
S, M, L, XL, 2XL, 3XLColor Name — Contains Any —
Black, White, Navy, Red
Both filters combined with “And” import only variants matching both conditions.
Do filters need to stay active for ongoing sync?
Yes. Filters determine which products SupplyMaster actively manages and syncs. If you remove a product from your filters and run a sync, that product will no longer receive inventory or pricing updates. It remains in your Shopify store but is no longer managed by SupplyMaster.
What is the most efficient way to filter multiple style numbers?
Use a single filter with all style numbers separated by commas (e.g., PTS30, PTS20, 112P) with the Contains Any or Equal To Any condition. This is easier to manage than multiple separate filters connected by “OR.”
Importing Products
I want two versions of the same product (e.g., embroidered and patched). How do I keep inventory synced for both?
Create a second supplier connection for the alternate version and add all relevant styles to that supplier. This maintains distinct product listings while keeping inventory synced for both through SupplyMaster.
Can I sync only colors without sizes (e.g., just the color options)?
No. In the supplier’s database and in Shopify, each variant is defined by the full combination of color and size. SKUs, barcodes, prices, and weights are all tied to complete variant combinations. You must sync the full variant set, but you can use variant filters to limit which sizes and colors are included.
How do I import only certain sizes or colors?
Use a variant filter for Size Name set to Equal To Any with only the sizes you want (e.g., S, M, L, XL). You can do the same for Color Name. This gives you a curated catalog with only the variants you want to sell. You can also hide the size selector on your storefront using theme customization if needed.
Can I install SupplyMaster on a Shopify development account?
No. SupplyMaster requires a paid Shopify plan. Development and trial stores are not supported.
Variant Limits
How are variants counted?
Each unique combination of size, color, and other options is one variant. A t-shirt with 5 sizes and 20 colors = 100 variants (5 × 20). Your subscription tier is based on total variant count.
What are “product updates” and why do I need so many per month?
A product update is one refresh of a variant’s data (inventory, price, fields) from the supplier. If you have 3,000 variants syncing daily, that’s 3,000 updates per day or about 90,000 per month.
Do I need variant splitting?
Almost certainly not. Shopify now supports 2,048 variants per product for all stores, which is enough to handle virtually every supplier product without splitting. Variant splitting is a legacy feature that exists only to support stores that originally imported products under the old 100-variant limit and already have split products in their store. New setups do not need it. See our Variant Splitting (Legacy Feature) article for details.
What happens if I need more than 50,000 variants?
Non-Shopify-Plus stores have a 50,000-variant limit set by Shopify. After reaching this limit, Shopify throttles creation to 1,000 new variants per day. SupplyMaster manages this automatically, gradually importing products over time. Shopify Plus stores do not have this limit.
Images
Can I set a specific image as the default product image?
SupplyMaster does not support changing which image is the default/featured image. Image URLs can be imported as metafields, but they won’t replace the main product image.
How do I import multiple images per color variant?
Shopify allows only one image per variant by default. You can import additional image URLs (e.g., side and back images) as metafields using Match Fields, then display them on your storefront with theme customization. See our Displaying Supplier Data on Your Shopify Theme article.
Some products imported without images. Will they be fixed on the next sync?
The most reliable fix is to delete those products from your Shopify store. SupplyMaster will recreate them with complete data (including images) on the next sync. Waiting for a sync to fix missing images on existing products may not work unless Always Update Variant Images is enabled.
Syncing & Updates
Will new products get images if Update Settings is set to “All Fields Except Images”?
Yes. Newly imported products always receive images on their first import, regardless of Update Settings. The “All Fields Except Images” setting only applies to existing products that have been in your store for more than 2 hours. This grace period ensures new products are fully populated.
What should I do if my import is stuck or shows “data processing”?
Check the Sync History tab for status updates. If you see a failed import or the issue persists for more than an hour, contact support. Common causes include temporary supplier API issues, large catalog sizes, or subscription limits being reached.
Can I set products to “inventory not tracked” or “continue selling when sold out”?
SupplyMaster does not have a built-in option for this. However, you can bulk-edit products in Shopify to enable “Continue selling when sold out.”
After switching suppliers (e.g., AlphaBroder to S&S), why are metafields and categories reset?
Different suppliers have different product IDs, APIs, and data formats. Shopify treats imported products from a new supplier as new products. To manage duplicates, turn on auto-archive for the old supplier, modify its filters so no products are selected, and run a sync to archive old products. You will still need to reassign metafields, categories, and collections on the new products.
Inventory & Locations
How do I import inventory for a specific warehouse location?
Go to Edit Supplier → Inventory Settings. Select the Shopify location and choose which supplier warehouse to map. Warehouse-level inventory is supported for:
S&S Activewear — individual U.S. and Canadian warehouses (e.g., Reading PA, Jacksonville FL, Olathe KS, and more)
AlphaBroder — All Inventory or Dropshipping Inventory Only
SanMar and other suppliers currently provide only total inventory quantities, not warehouse-level breakdowns.
Does imported inventory show to customers on my storefront?
Inventory levels are visible in your Shopify admin but are not automatically displayed to storefront visitors. To show stock levels to customers, customize your theme or use a Shopify app. See this Shopify Community discussion.
How do I hide zero-inventory products from my storefront?
This is a Shopify setting, not a SupplyMaster feature. Go to your Shopify admin and configure your theme or collection settings to hide out-of-stock products. See Shopify’s guide on hiding sold-out variants.
Deleting & Archiving Products
If I delete products from Shopify, will SupplyMaster re-import them?
Yes. If the products are still in the supplier’s catalog and still match your active filters, SupplyMaster will recreate them on the next sync. To prevent this, update your filters to exclude those products before deleting them from Shopify.
What is the best way to delete products through SupplyMaster?
Exclude from filters — go to Edit Filters and remove the products you want to delete.
Enable auto-archive — in Automatic Sync, set Action on Unavailable Products to Archive Products.
Run a sync — SupplyMaster will archive the excluded products.
Review and delete — in Shopify admin, filter to “Archived” products, review, and permanently delete.
This method is safe (archive first, delete second) and prevents SupplyMaster from recreating deleted products on future syncs.
Auto Create Settings
How do I control whether new products or variants are created during sync?
The Auto Create Products & Variants setting (in Edit Supplier → Automatic Sync) offers four levels:
Always Create Products & Variants (default) — full automation for resellers.
No New Variants on Existing Products — protects customized variant selections for decorators.
No New Products — updates existing products but doesn’t add new product lines, for curated catalogs.
No New Products or Variants — only pricing, inventory, and data updates, for finalized catalogs.
This setting can be configured per supplier and applies to both automatic and manual imports.
Other
How can I change the brand name or vendor for imported products?
Go to Match Fields, find the Vendor row, click Modify, and enter your custom vendor name or a Liquid formula.
How can I add SanMar spec PDFs to product listings?
SanMar specification PDF links can be mapped to a product metafield using Match Fields. After importing, display the PDF links on your storefront using Custom Liquid in your theme. See this Shopify Community discussion for implementation examples.
Need Help?
If you have questions or need assistance, contact support on chat in the bottom-right corner of the app.