Troubleshooting

Common Problems and Solutions

FBT block is not displayed

Possible causes:

1. Module is disabled

   • Go to WPify → SalesBoosterExtras
   • Enable Frequently bought together

2. No display location selected

   • Select at least one hook in Display locations

3. No recommendation data yet

   • Run Index tools → Backfill
   • Or create test orders and move them to processing / completed

4. No recommendations for this product

   • The product may not have co-purchase history yet
   • Use product override mode replace or merge and add manual products

5. Current product context missing (shortcode)

   • If using shortcode outside product templates, pass product_id

---

Backfill progress does not move

Possible causes:

1. No eligible orders

   • Only processing and completed orders are indexed

2. All orders already indexed

   • Run Rebuild and backfill to rebuild from scratch

3. JavaScript error in admin

   • Open browser console and check errors on the FBT settings page

4. Timeout / server resource limits

   • Reduce Backfill batch size (e.g. from 500 to 100)

---

Rebuild finishes but rows stay at 0

Possible causes:

1. Orders contain fewer than 2 unique normalized products

   • FBT only stores pairs, so single-product orders do not create rows

2. Ignored product types

   • external and grouped are skipped

3. Bundle/composite child rows only

   • The module indexes parent line items only

4. Orders are not in processing or completed

   • Change status or use test orders in supported statuses

---

Slider shows multiple rows

Cause: Theme WooCommerce grid CSS overrides the slider list styles.

Notes:

• The module includes extra overrides for Woo loop template + slider mode (including Astra-style Woo grids).
• Hard refresh the page after asset rebuilds / updates.

If the issue persists:

1. Check the root FBT block has .sbe-fbt--slider
2. Check the list has .sbe-fbt__list--woocommerce
3. Inspect theme CSS overriding ul.products / li.product width, float, or clear

---

Slider dots/arrows do not appear

Possible causes:

1. Display type is not Slider

   • Dots/arrows render only for slider mode

2. Toggles disabled

   • Enable Show slider dots / Show slider arrows

3. Only one slide

   • Dots/arrows are hidden when there is only one item

4. JavaScript error

   • Check browser console

---

AJAX render mode does not show the block

Possible causes:

1. REST API blocked

   • Check /wp-json/sales-booster-extras/v1/fbt-render?...

2. JavaScript error on product page

   • Check browser console

3. Page not a product context and no product_id in shortcode

   • Pass product_id explicitly

---

Product override does not work

Possible causes:

1. Wrong mode selected

   • auto ignores manual products
   • use replace or merge

2. Manual products contain unsupported types

   • external and grouped are filtered out

3. Draft/private products

   • Only published products are shown

Support Checklist

When reporting an issue, include:

• WordPress + WooCommerce version
• whether HPOS is enabled
• theme name (especially for slider layout issues)
• FBT settings screenshot
• example product URL
• browser console errors (if any)