Skip to main content

Automatic Tagging for Subscription Customers

G
Written by George Buckley
Updated over 3 months ago

SubZero Subscriptions App offers powerful automatic tagging capabilities to help you manage customers and orders throughout the subscription lifecycle. These tags enable custom notification frameworks, enhanced customer segmentation, and improved reporting within Shopify.

Available Tag Types

Customer Tags

Automatically tag customers based on their subscription status and activity:

  • Active subscription tags - Applied to customers with active subscriptions

  • Cancelled subscription tags - Applied when customers cancel subscriptions

  • Failed payment tags - Applied when subscription renewal payments fail

Order Tags

Automatically tag orders based on their role in the subscription:

  • Initial order tags - Applied to orders that originated a customer's subscription

  • Renewal order tags - Applied to recurring subscription orders (not initial orders)

Use Cases

These tagging capabilities allow you to:

  • Create custom notification workflows via third-party email apps like Klaviyo

  • Filter shop functionality for specific customer segments

  • Enhance customer segments and reporting within Shopify

  • Build automated marketing campaigns based on subscription behavior

Setting Up Subscription Tags

Creating Customer and Order Tags

Important: Subscription tags can only be specified when creating subscription plans. It's not currently possible to edit these tags after plan creation.

How to configure:

  1. When setting up subscription plan groups and plans

  2. Navigate to the "Subscription group tag setup" block

  3. Specify your desired tag options

Customer Tag Behavior

Active Subscription Tags:

  • Applied automatically to customers with active subscriptions

  • Remain on customer records throughout the subscription period

  • Removed within 24 hours if:

    • Subscription is cancelled or paused

    • Payment method expires or is declined

    • Customer doesn't renew at the end of their billing cycle

Example: For a monthly subscription, the active tag remains until the following month. If renewal succeeds, the tag continues for another month. If renewal fails, the tag is removed within 24 hours.

Cancelled Subscription Tags:

  • Applied immediately when customers cancel their subscription

  • Can coexist with active subscription tags if the subscription period hasn't ended yet

  • Removed immediately when customer purchases a new subscription only if the cancellation tag text matches exactly

Important: If a customer has a cancellation tag "cancelled-subscription" and purchases a new subscription with a different cancellation tag "cancelled-new", they will retain the original "cancelled-subscription" tag.

Order Tag Behavior

Initial Order Tags: Applied to the first order that created the customer's subscription.

Subscription Order Tags: Applied to all renewal orders (excluding the initial order).

Failed Payment Tags

Failed payment tags are configured separately from subscription plan tags.

Setup Process

  1. Go to the Settings section of SubZero Subscriptions App

  2. Scroll to "Billing and payment settings"

  3. Click "Enable" next to the failed payment tag option

  4. Enter your desired tag value in the "Failed payment tag" text box

  5. Click "Save"

Failed Payment Tag Behavior

  • Applied when any customer subscription renewal payment fails

  • Removed when customer updates payment information or any billing succeeds

  • Global scope: Not specific to any subscription group or plan

  • Reflects the overall payment status across all of a customer's subscriptions

Tag Application Timing

When Tags Are Applied

Tags are applied automatically during these events:

  • Order creation

  • Subscription creation

  • Subscription cancellation

  • Payment failures

Processing Delays

Typical timing: Tags are usually applied within a few seconds of the triggering event.

Expected delays:

  • Active subscription tags: Applied within seconds of subscription purchase

  • Cancellation tags: Applied within seconds of cancellation

  • Order tags: Applied within seconds of order creation

  • Failed payment tags: Applied within seconds of payment failure

Best Practices

Tag Naming Conventions

  • Use consistent, descriptive tag names

  • Consider your integration needs (Klaviyo, other apps)

  • Plan for scalability across multiple subscription types

Tag Strategy Planning

  • Map out your customer journey and identify key tagging points

  • Consider how tags will work with your email marketing automation

  • Test tag behavior in a development environment before going live

Integration Considerations

  • Ensure your email marketing platform can handle tag updates

  • Set up appropriate segments in Shopify based on your tags

  • Monitor tag application to ensure proper functionality

Troubleshooting

Common Issues

  • Tags not applying: Check that tags are configured in the subscription plan setup

  • Tags not removing: Verify the exact tag text matches between plans

  • Failed payment tags not working: Ensure the feature is enabled in Settings

Need Help?

If you encounter issues with automatic tagging or need assistance with tag configuration, contact our support team for help.

Did this answer your question?