Common Issues and Solutions
Quick solutions to the most frequently encountered problems.
Subscription Issues
Customers Can't Subscribe
Problem: Customers do not see the option to subscribe to a product
Solutions:
- Check if the Zubs subscription widget is added to the products page
- Check if the product has subscriptions enabled
- Ensure inventory is available
- Check if the product is published and active
Subscription Orders Not Creating
Problem: Subscriptions are created but recurring orders aren't being generated.
Solutions:
- Check if the subscription is active (not cancelled)
- Ensure billing dates are set correctly
- Verify payment method is still valid
Technical Issues
App Not Loading
Problem: The Zubs app doesn't load in Shopify admin.
Solutions:
- Clear browser cache and cookies
- Try a different browser
- Check if you're logged into the correct Shopify account
Customer Support Issues
Customer Can't Manage Subscription
Problem: Customers can't access their subscription management portal.
Solutions:
- Verify customer account is active
- Check if customer has valid email address
- Ensure subscription management is enabled (learn more here)
Customer Sees an Error Instead of Their Subscription
Problem: A customer opens the subscription portal and sees "We couldn't load your subscription settings" with a Try again button, instead of their subscription.
Solutions:
- Ask them to press Try again — this is usually a temporary connection problem and clears on the second attempt
- If it persists, have them reload the page or come back in a minute
- If it still appears, contact support with the customer's email address and roughly when they tried
Zubs shows this instead of the subscription on purpose. When it can't confirm your settings, it doesn't guess — so a temporary glitch can never let a customer use an action you've switched off, or pick products outside your subscription collection.
Email Notifications Not Sending
Problem: Customers aren't receiving subscription-related emails.
Solutions:
- Check email configuration in app settings (is email sending activated?)
- Verify customer email addresses are correct
- Check spam/junk folders
Merchant Portal Access Issues
Missing Features or Restricted Actions
Problem: You cannot see cancellation reasons, modify them, cancel subscription contracts, or make other changes in the Merchant Portal.
Solution: The Shopify user account you are logged in with needs sufficient permissions. Make sure the user has at least the following permissions enabled in Shopify:
- Orders → View
- Orders → Manage order information
- Customers → View
- Content → Entries → View, Create and edit, Delete
- Store settings → Manage settings
You can manage user permissions in your Shopify admin under Settings → Users and permissions.
Getting Help
If you're still experiencing issues:
- Check our documentation for detailed guides
- Search our knowledge base for similar issues
- Contact support with specific error messages
- Include screenshots when possible
Contact Information
- Email: support@zubs.app