{"id":10526,"date":"2025-09-22T20:04:01","date_gmt":"2025-09-23T00:04:01","guid":{"rendered":"https:\/\/learndash.com\/support\/?post_type=docs&p=10526"},"modified":"2025-09-23T09:42:27","modified_gmt":"2025-09-23T13:42:27","password":"","slug":"how-to-configure-subscription-groups","status":"publish","type":"docs","link":"https:\/\/learndash.com\/support\/kb\/learndash-app\/in-app-purchases\/how-to-configure-subscription-groups\/","title":{"rendered":"How to Configure Subscription Groups"},"content":{"rendered":"\n

Introduction<\/strong><\/h2>\n\n\n\n

Subscription Groups allow you to organize related subscription products like tiered membership plans or varying billing cycles so users can only hold one active subscription per group<\/strong>.<\/p>\n\n\n\n

This guide shows you how to create, sync, and assign subscription groups in the Learndash App plugin to deliver a consistent upgrade\/downgrade experience across both iOS and Android.<\/p>\n\n\n\n

Why Use Subscription Groups?<\/strong><\/h2>\n\n\n\n
    \n
  • Tiered Plans:<\/strong> Offer Bronze, Silver, and Gold memberships without overlap.
    <\/li>\n\n\n\n
  • Duration Options:<\/strong> Sell monthly, quarterly, or yearly access with a clear structure.
    <\/li>\n\n\n\n
  • Auto-Switching:<\/strong> Automatically cancel the old subscription when users purchase a new one in the same group.
    <\/li>\n<\/ul>\n\n\n\n

    Understand Requirements<\/strong><\/h2>\n\n\n\n
      \n
    • iOS (App Store Connect):<\/strong> Apple requires<\/strong> all auto-renewable subscriptions<\/strong> to be assigned to a Subscription Group<\/strong>. Other product types cannot be grouped.
      <\/li>\n\n\n\n
    • Android (Google Play):<\/strong> Google doesn\u2019t support subscription groups<\/strong> natively. Learndash App provides group logic so Android users get the same seamless experience.
      <\/li>\n<\/ul>\n\n\n\n

      To ensure consistency, you’ll need to mirror your iOS subscription groups in WordPress<\/strong> and manually assign both iOS and Android products.<\/p>\n\n\n\n

      Create Subscription Groups in App Store Connect<\/strong><\/h2>\n\n\n\n
        \n
      1. Log into your App Store Connect<\/strong> account.
        <\/li>\n\n\n\n
      2. Go to My Apps<\/strong>, then select your app.
        <\/li>\n\n\n\n
      3. Under In-App Purchases<\/strong>, click Subscription Groups<\/strong>.
        <\/li>\n\n\n\n
      4. Make a note of each group name (e.g., \u201cMembership Tiers\u201d, \u201cMonthly Plans\u201d).
        <\/li>\n<\/ol>\n\n\n\n

        Add Subscription Groups in the Learndash App Plugin<\/strong><\/h2>\n\n\n\n
          \n
        1. In your WordPress Dashboard, go to Learndash App > In-App Purchases<\/strong>.
          <\/li>\n\n\n\n
        2. Click the Subscription Groups<\/strong> tab.
          <\/li>\n\n\n\n
        3. For each group name from App Store Connect:
          \n
            \n
          • Click Add New Subscription Group<\/strong>.
            <\/li>\n\n\n\n
          • Paste the name exactly as it appears.
            <\/li>\n\n\n\n
          • Click Save<\/strong>.
            <\/li>\n<\/ul>\n<\/li>\n<\/ol>\n\n\n\n

            Assign Products to Subscription Groups<\/strong><\/h2>\n\n\n\n
              \n
            1. In Learndash App > In-App Purchases<\/strong>, switch to the Products<\/strong> tab.
              <\/li>\n\n\n\n
            2. Click Add New<\/strong> or Edit<\/strong> next to a subscription product.
              <\/li>\n\n\n\n
            3. Ensure:
              \n
                \n
              • Product Type<\/strong> is set to Auto-Renewable Subscription<\/strong> (iOS) and Subscription<\/strong> (Android).
                <\/li>\n\n\n\n
              • Under Subscription Group<\/strong>, select the correct group name.
                <\/li>\n<\/ul>\n<\/li>\n\n\n\n
              • Click Update Product<\/strong>.
                <\/li>\n<\/ol>\n\n\n\n

                Troubleshooting and FAQs<\/strong><\/h2>\n\n\n\n

                Q: Why are my Android subscriptions not grouped?<\/strong>
                <\/strong> A: Android doesn\u2019t support subscription groups natively. Use the plugin to mirror Apple\u2019s groups and assign them manually.<\/p>\n\n\n\n

                Q: A user has two subscriptions active at once. What\u2019s wrong?<\/strong>
                <\/strong> A: Check if both products are assigned to the same Subscription Group<\/strong>. If not, auto-cancel logic won’t trigger.<\/p>\n\n\n\n

                Q: I accidentally added a one-time product to a group. Will that break anything?<\/strong>
                <\/strong> A: Yes. Only subscription-type products can belong to Subscription Groups. Edit the product and remove it from the group.<\/p>\n","protected":false},"excerpt":{"rendered":"

                Introduction Subscription Groups allow you to organize related subscription products like tiered membership plans or varying billing cycles so users can only hold one active subscription per group. This guide shows you how to create, sync, and assign subscription groups in the Learndash App plugin to deliver a consistent upgrade\/downgrade experience across both iOS and…<\/p>\n","protected":false},"author":58,"featured_media":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_helpful_status":1,"_kad_blocks_custom_css":"","_kad_blocks_head_custom_js":"","_kad_blocks_body_custom_js":"","_kad_blocks_footer_custom_js":"","_swpsp_post_exclude":false,"_kad_post_transparent":"","_kad_post_title":"","_kad_post_layout":"","_kad_post_sidebar_id":"","_kad_post_content_style":"","_kad_post_vertical_padding":"","_kad_post_feature":"","_kad_post_feature_position":"","_kad_post_header":false,"_kad_post_footer":false,"footnotes":""},"doc_category":[290],"doc_tag":[],"knowledge_base":[283],"class_list":["post-10526","docs","type-docs","status-publish","hentry","doc_category-in-app-purchases","knowledge_base-learndash-app"],"year_month":"2026-04","word_count":395,"total_views":"596","reactions":{"happy":"0","normal":"0","sad":"0"},"author_info":{"display_name":"Stephanie Liy","author_link":"https:\/\/learndash.com\/support\/author\/stephaniei\/"},"doc_category_info":[{"term_name":"In-App Purchases","term_url":"https:\/\/learndash.com\/support\/kb\/learndash-app\/in-app-purchases\/"}],"doc_tag_info":[],"taxonomy_info":{"doc_category":[{"value":290,"label":"In-App Purchases"}],"knowledge_base":[{"value":283,"label":"LearnDash App"}]},"featured_image_src_large":false,"comment_info":0,"knowledge_base_info":[{"term_name":"LearnDash App","term_url":"https:\/\/learndash.com\/support\/kb\/learndash-app\/","term_slug":"learndash-app"}],"knowledge_base_slug":["learndash-app"],"_links":{"self":[{"href":"https:\/\/learndash.com\/support\/wp-json\/wp\/v2\/docs\/10526","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/learndash.com\/support\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/learndash.com\/support\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/learndash.com\/support\/wp-json\/wp\/v2\/users\/58"}],"replies":[{"embeddable":true,"href":"https:\/\/learndash.com\/support\/wp-json\/wp\/v2\/comments?post=10526"}],"version-history":[{"count":1,"href":"https:\/\/learndash.com\/support\/wp-json\/wp\/v2\/docs\/10526\/revisions"}],"predecessor-version":[{"id":10527,"href":"https:\/\/learndash.com\/support\/wp-json\/wp\/v2\/docs\/10526\/revisions\/10527"}],"wp:attachment":[{"href":"https:\/\/learndash.com\/support\/wp-json\/wp\/v2\/media?parent=10526"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/learndash.com\/support\/wp-json\/wp\/v2\/doc_category?post=10526"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/learndash.com\/support\/wp-json\/wp\/v2\/doc_tag?post=10526"},{"taxonomy":"knowledge_base","embeddable":true,"href":"https:\/\/learndash.com\/support\/wp-json\/wp\/v2\/knowledge_base?post=10526"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}