Fix the most common setup and display issues
The Dashboard shows a badge reading "App embed is not active".
Variant Table and Collection Quick Order both require the app embed to be turned on in your theme. Go to your Shopify theme editor → App embeds → turn on Sami Bulk Order → save. See Getting Started.
Quick Order Form doesn't insert itself automatically. Check that:
The form is set to Active, not Draft.
You copied the correct Shortcode from the form's Visibility tab.
The shortcode is pasted into a SamitaBO quick order form app block added through the theme editor, and that block is on the page/template you expect.
The form's Customer visibility and Display location rules actually match the customer/page you're testing with.
If more than one form's visibility rules match the same product or page, only the most recently saved one is shown. Narrow each form's Customer/Product targeting so only one is meant to match.
Thresholds must increase in this order: Last items < Low stock < In stock. If you see:
"Last items threshold must be greater than 0"
"Low stock threshold must be greater than 0"
"In stock threshold must be greater than 0"
"Last items threshold must be less than low stock threshold"
"Low stock threshold must be less than in stock threshold"
...adjust the values so each threshold is both greater than 0 and greater than the one before it. See Stock Status.
The Quick Order Form's pagination setting only accepts a value in that range. Use one of the preset options (10/20/40/50/100) or pick a custom value inside the limit.
"This file type isn't supported for automatic import yet. Please use a CSV or XLSX file." — the uploaded format isn't one of CSV, XLSX, PDF, JPEG, PNG, or Enable file upload doesn't include that file type.
"Couldn't read this file. Please check the format and try again." / "No matching SKU/Quantity rows were found in this file." — for CSV/XLSX, make sure the file has a SKU column (and optionally Qty/Quantity).
"We couldn't read this image automatically. Please try a CSV or XLSX file." — the AI parser couldn't extract rows from a PDF or image; ask the customer to try a clearer file or use CSV/XLSX instead.
See Quick Order Form.
The cart toast only fires for Collection Quick Order and Variant Table add-to-cart actions, and only if "Show toast after add to cart" is turned on in Settings > Toast. Quick Order Form doesn't use this toast at all — it shows its own inline cart summary.
Customers search for a product that should be included, but the form shows no results.
The app relies on a small file it adds to your theme to power fast product search inside the Quick Order Form. If your theme was updated, replaced, or the app embed was reinstalled after that file was removed, search can fall back to a slower method that may not return results for large catalogs.
To fix it:
Make sure the app embed is turned on and saved again in the theme editor (see Getting Started).
Re-publish your theme if you recently switched themes.
If search still returns no results, contact support (see below) so the missing file can be re-added.
Go to Contact Us in the app navigation and send a message — it goes directly to the Samita support team.
Last updated
Was this helpful?
Was this helpful?
