Skip to main content

Troubleshooting Widget Display Issues

Solutions for common problems when widgets don’t appear correctly

Tom Nipravsky avatar
Written by Tom Nipravsky
Updated over a month ago

Widgets not showing up as expected? This guide covers common display issues and how to fix them.

Check App Embed Status

Before troubleshooting specific issues, verify the basics:

  1. Verify Triom app is installed and active in Shopify

  2. Make sure Triom app embed is enabled in your Shopify theme.

Widget Not Appearing at All

Check Widget Status

The most common issue—the widget isn't set to Live.

Fix:

  1. Go to Triom > Widgets

  2. Find your widget

  3. Toggle status to Live

Check Display Method

Embedded widgets need theme editor placement; popups work automatically.

For Embedded Widgets:

  1. Go to Shopify > Online Store > Themes > Customize

  2. Verify the widget section/block is added

  3. Check the correct Widget ID is pasted in the settings

For Popup Widgets:

  1. Verify display method is set to Popup in widget settings

  2. Check the trigger conditions are being met

  3. Test the trigger (add to cart, scroll to percentage, etc.)

Check Data Rule

Your Data Rule might not match the current page or return no products.

Fix:

  1. Open your widget > Settings > Data Rules

  2. Check the conditions—are they too restrictive?

  3. Verify the current product/page meets those conditions

  4. Test with a product you know should match

Note: Widgets with no matching products are not displayed.

Widget Looks Wrong

Styling Not Applied

Custom design settings aren't showing.

Fix:

  1. Ensure changes are saved in Triom

  2. Hard refresh the page (Cmd/Ctrl + Shift + R)

  3. Check if the widget is in "Draft" mode (some settings only apply when Live)

Mobile Layout Issues

Widget doesn't fit properly on mobile screens.

Fix:

  1. Check widget responsive settings

  2. Consider hiding on mobile if it doesn't fit

  3. Use a more mobile-friendly layout (stacked vs horizontal)

Popup Not Triggering

Trigger Conditions Not Met

The specific trigger event hasn't occurred.

Triggers to check:

  • Page load - Should appear after set delay

  • Scroll percentage - Must scroll to that point

  • Add to cart - Must actually add a product

  • Checkout click - Must click checkout button

Fix:

  1. Test by performing the trigger action

  2. Reduce delay if using page load trigger

  3. Lower scroll percentage threshold for testing

Still Having Issues?

Gather Information

Before contacting support, note:

  • Widget name

  • Page URL where issue occurs

  • Expected vs actual behavior

  • Browser and device used

  • Screenshot of the issue

Test in Isolation

  1. Create a simple test widget with minimal settings

  2. Add it to your theme

  3. If test widget works, issue is with original widget settings

  4. If test widget fails, issue may be theme or app-related

Contact Support

If issues persist:

  • Use the in-app chat

  • Email support with gathered information

Did this answer your question?