Why aren’t my tags applying correctly?

Introduction

If it looks like your Tag Library rules aren’t working, don’t worry — it usually comes down to a simple configuration issue. Since Roadmap’s rules replace Shopify’s manual tags and Flow automations, it’s important to check how eligibility, visibility, and fallback settings are defined.

Here’s how to troubleshoot common issues.

1. Check Rule Conditions

• Make sure the eligibility criteria match your test scenario.
• Examples:
  • If the rule applies only to logged-in customers, test with a logged-in account.
  • If the rule requires order history, test with a customer who has a past order.
  • If the rule applies to specific countries, check that your test customer is set to that country.

👉 Tip: Use a test customer account with the right profile to verify conditions.

2. Check Visibility Settings

• Ensure the rule is set to Visible (to show products/pages) or Hidden (to restrict them).
• If it’s set to “Hidden” for your segment, customers won’t see the content even if the rule is working.

3. Check Active Dates and Fallback

• If your rule is scheduled, confirm the start date and time has passed.
• If an end date is set, the fallback state (Visible or Hidden) will take over after expiry.
• Example: A promotion may seem missing because the end date passed and fallback = Hidden.

4. Look for Overlapping Rules

• If you have multiple rules on the same product, collection, or page, the more specific rule takes priority.
• Example:
  • Rule 1: All logged-in customers can see Collection A.
  • Rule 2: Only VIPs can see Product X (inside Collection A).
  • Result: Non-VIPs won’t see Product X, even though they can see Collection A.

5. Check App Block Placement

• If a widget (bundle, loyalty, review) isn’t showing, confirm the Roadmap app block is placed correctly in the Shopify theme editor.
• Rules can only control visibility if the app block exists on the page.

6. Verify Analytics Attribution

• Rules always apply in the background, even if you can’t “see” them directly.
• Check Roadmap Analytics → Filters to confirm the rule is being enforced (sales, AOV, or orders attributed to that rule).

Common Questions

• Do Roadmap rules update in real time?
  • Yes — conditions are applied instantly when a customer qualifies.
• Why can’t I see the rule name in Shopify tags?
  • Roadmap rules don’t use Shopify tags — they run as logic rules within Roadmap.
• Do rules apply to old customers/orders too?
  • Yes — rules apply retroactively to all data that meets the condition.
• What happens if no customers meet my rule?
  • The rule is still active — it just won’t show results until someone qualifies.

Cross-Feature Links

• How do I create a new Tag Library rule?
• Can I apply multiple Tag Library rules at once?
• How do Tag Library rules affect reporting and analytics?

Summary

If your Tag Library rules don’t seem to be applying, check the conditions, visibility, active dates, fallback, overlapping rules, and app block placement. Remember — rules don’t create Shopify tags, they apply logic automatically in Roadmap. Use Analytics filters to confirm attribution and test with different customer scenarios.