> For the complete documentation index, see [llms.txt](https://docs.samita.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.samita.io/b2b-bulk-order/support/troubleshooting.md). # Troubleshooting ## Widgets aren't showing on my storefront at all {% hint style="warning" %} The Dashboard shows a badge reading **"App embed is not active"**. {% endhint %} 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](/b2b-bulk-order/getting-started.md#activate-the-app-embed). ## My Quick Order Form doesn't appear on the page I added it to Quick Order Form doesn't insert itself automatically. Check that: 1. The form is set to **Active**, not Draft. 2. You copied the correct **Shortcode** from the form's Visibility tab. 3. 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. 4. The form's **Customer visibility** and **Display location** rules actually match the customer/page you're testing with. ## Variant Table or Collection Quick Order shows the wrong configuration on a product 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. ## I can't save Stock thresholds 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](/b2b-bulk-order/features/stock-status.md). ## "Products per page must be between 1 and 250" 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. ## A customer's uploaded order file isn't working * **"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](/b2b-bulk-order/features/quick-order-form.md#letting-customers-upload-an-order-file). ## Cart toast isn't showing 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. ## Quick Order Form search returns no results {% hint style="warning" %} Customers search for a product that should be included, but the form shows **no results**. {% endhint %} 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: 1. Make sure the app embed is turned on and saved again in the theme editor (see [Getting Started](/b2b-bulk-order/getting-started.md#activate-the-app-embed)). 2. Re-publish your theme if you recently switched themes. 3. If search still returns no results, contact support (see below) so the missing file can be re-added. ## Still stuck? Go to **Contact Us** in the app navigation and send a message — it goes directly to the Samita support team. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.samita.io/b2b-bulk-order/support/troubleshooting.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.