Troubleshoot Spotler Activate Issues in Magento 2

Symptoms:

• Feed Log shows errors
• CLI command returns error
• Empty or incomplete feed file

Solution:

1. Enable debug mode: Spotler > General > Debug > Debug Mode = Yes
2. Run feed generation: bin/magento sooqr:feed:create
3. Check logs:

   tail -200 var/log/sooqr-debug.log
   

Common causes:

• Memory limit exceeded (lower batch size)
• Database timeout (check slow queries)
• Invalid product data (specific product causing error)

Prevention: Run feed generation during off-peak hours for large catalogs.

Symptoms:

• Fewer products in Spotler than expected
• Specific products don't appear in search

Solution:

1. Check product visibility: Must be "Catalog", "Search", or "Catalog, Search"
2. Check product status: Must be Enabled
3. Check stock status: If "Exclude Out of Stock" is enabled
4. Check category filters: Product must be in included categories

For configurable products:

• Simple products must meet filter criteria too
• Check if "Only Linked Simple Products" is selected

Debug specific product: Enable debug mode and check logs for why product was skipped.

Symptoms:

• 404 when accessing feed URL
• Spotler can't fetch feed

Solution:

1. Verify feed was generated: Check Feed Log
2. Check filename in configuration matches
3. Verify webserver can serve XML files from pub/media/sooqr/
4. Check file permissions on generated feed

Test locally:

curl -I https://yourstore.com/media/sooqr/feed.xml

Symptoms:

• Products link to wrong page
• Simple products don't link to parent

Solution: Check Product Types configuration:

• Use Parent URL for Simples should be "Yes" or "Yes, with Auto-Link"
• Verify URL rewrites are enabled in Magento

Symptoms:

• Products show without images in Spotler
• Placeholder images appearing

Solution:

1. Check Image Source setting in Product Data
2. Verify products have images assigned
3. For simples: Check "Use Parent Image for Simples" setting
4. Ensure image cache is generated: bin/magento catalog:images:resize

Symptoms:

• Typing in search box shows native Magento results
• No Spotler overlay

Solution:

1. Verify Enable Search = Yes
2. Check Account ID is configured for the store view
3. Clear full page cache
4. Check browser console for JavaScript errors

Check script loading: View page source, search for "sooqr" - the loader script should be present.

Common causes:

• Account ID missing or wrong format
• JavaScript conflict with other extensions
• CSP blocking the Spotler script

Symptoms:

• Spotler overlay appears but empty
• "No results found" for everything

Solution:

1. Verify feed was successfully fetched by Spotler
2. Check Spotler dashboard - is the index built?
3. Regenerate feed and wait for Spotler to reindex

Note: After first feed generation, Spotler needs time to index. Can take up to an hour.

Symptoms:

• Clicking "Add to Cart" in search results does nothing
• Error messages when adding

Solution:

1. Verify Add to Cart Controller = Yes in Search configuration
2. Check for JavaScript errors in browser console
3. For Ajax: Verify "Use Ajax based Add to Cart" = Yes

Common cause: Form key issues. Clear cache and try again.

Symptoms:

• No search data in Spotler analytics
• Click tracking not working

Solution:

1. Verify Statistics = Yes in Search configuration
2. Check browser console for blocked requests
3. Verify CSP isn't blocking Spotler tracking

Symptoms:

• Generation takes hours
• Timeouts during generation

Solution:

1. Lower batch size in configuration
2. Run during off-peak hours
3. Check for slow database queries
4. Disable debug mode if enabled

For very large catalogs:

• Consider filtering to reduce product count
• Schedule via cron rather than manual generation

Symptoms:

• Long delay before results appear
• Overlay loads slowly

Solution: This is usually a Spotler-side issue, not the extension. Check:

1. Network latency to Spotler CDN
2. Index size in Spotler dashboard
3. Contact Spotler support for server-side issues

Navigate to: Spotler > General > Debug > Debug Mode = Yes

var/log/sooqr-debug.log

# Recent entries
tail -100 var/log/sooqr-debug.log

# Follow in real-time during generation
tail -f var/log/sooqr-debug.log

• Product skipped reasons
• API call responses
• Error messages
• Processing time per batch