AndOr documentation

AndOr runs discounts that shoppers can see on your store, and rules that control your Shopify checkout. These guides show you how to set up each part, step by step.

Start here

• 1Install the appAdd AndOr from the Shopify App Store and turn on the app embed.
• 2Open the appFind your way around Home, Promotions, Rules and Analytics.
• 3Create your first promotion or ruleA discount shoppers can see, or a rule for your checkout.
• 4See it on your storeCheck it on your storefront and at checkout before you go live.

All guides

• Get started

  Install the app, turn on the app embed and make your first promotion or rule.

  • What AndOr does
  • Promotions and upsell offers
  • Install and turn on the app embed
  • Theme requirements
  • See all 9 pages

• Promotions

  One discount with its storefront widgets and, for some types, an upsell offer.

  • How promotions work
  • Manage promotions
  • Brand color
  • Volume discount
  • See all 16 pages

• Upsell offers and gifts

  Show shoppers what to add to get a discount you already give.

  • How upsell offers work
  • Create an upsell offer
  • Offer types
  • Message and where it shows
  • See all 6 pages

• Storefront widgets

  The theme app blocks that show your discounts on the store.

  • Widgets overview
  • App embed
  • Add AndOr with code
  • Storefront text
  • See all 18 pages

• Themes

  How AndOr works on each theme we test: where blocks go, style tips, the cart drawer and quirks.

  • Themes overview
  • Horizon
  • Tinker
  • Dawn
  • See all 6 pages

• Checkout rules

  Hide, rename or reorder payment and shipping methods, and block checkouts.

  • How checkout rules work
  • Discounts
  • Validation
  • Payment
  • See all 6 pages

• Building rules

  Conditions, use cases, the flow visual editor, versions and more.

  • Conditions, groups and blocks
  • Condition reference
  • Several values in one field
  • One-typo matching
  • See all 12 pages

• Analytics

  See what your promotions and upsell offers add to your sales.

  • Analytics overview
  • Metrics
  • How we count
  • Tables and funnel
  • See all 6 pages

• AI and integrations

  Ask Shopify's Sidekick about your rules, or find what you need fast.

  • Sidekick
  • Quick finder

• Help

  Fixes for common problems, the FAQ, and how to reach us.

  • Widgets not showing
  • Discount not applying
  • Free gift not added, or not free
  • Rule not working at checkout
  • See all 10 pages

• Theme developers

  Style the widgets, paste one-line tags, listen to events and call the API.

  • Developer overview
  • App embed and blocks
  • One-line tags
  • Product card recipes
  • See all 18 pages

Looking for step-by-step guides, templates or the glossary? See Resources.