{"id":10410,"date":"2025-09-22T19:51:52","date_gmt":"2025-09-22T23:51:52","guid":{"rendered":"https:\/\/learndash.com\/support\/?post_type=docs&p=10410"},"modified":"2025-09-23T11:14:21","modified_gmt":"2025-09-23T15:14:21","password":"","slug":"how-to-migrate-require-purchase-functionality-in-your-learndash-app","status":"publish","type":"docs","link":"https:\/\/learndash.com\/support\/kb\/learndash-app\/advanced-learndash-app\/how-to-migrate-require-purchase-functionality-in-your-learndash-app\/","title":{"rendered":"How to Migrate Require Purchase Functionality in Your Learndash App"},"content":{"rendered":"\n

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

The Require Purchase<\/strong> setting allows you to restrict your entire app behind a single paywall. With Access Controls<\/strong>, you now gain the flexibility to set up granular, rule-based restrictions using memberships, courses, or custom logic.<\/p>\n\n\n\n

This guide shows you how to migrate your Require Purchase setup to the new Access Controls system using Access Groups and rules.<\/p>\n\n\n\n

Note:<\/strong> If you don\u2019t plan to enable Access Controls, your current Require Purchase setup will remain active. No action is required unless you want to migrate.<\/p>\n\n\n\n

Prerequisite: Note Your Existing Setting<\/strong><\/h2>\n\n\n\n

Before enabling Access Controls:<\/p>\n\n\n\n

    \n
  1. Go to Learndash App > Settings > In-App Purchases<\/strong>.
    <\/li>\n\n\n\n
  2. Take note of your Require Purchase<\/strong> setting.
    <\/li>\n\n\n\n
  3. Once Access Controls is enabled, this toggle will disappear, and its logic must be rebuilt manually using Access Groups.
    <\/li>\n<\/ol>\n\n\n\n
    \"Screenshot<\/figure>\n\n\n\n

    Activating Access Controls<\/strong><\/h2>\n\n\n\n

    To begin the migration:<\/p>\n\n\n\n

      \n
    1. Go to Learndash App > Components.<\/strong>
      <\/strong><\/li>\n\n\n\n
    2. Check Activate Access Controls<\/strong>.
      <\/li>\n\n\n\n
    3. Click Save Changes<\/strong>.
      <\/li>\n\n\n\n
    4. If prompted to migrate Require Purchase, click the migration link to continue.
      <\/li>\n<\/ol>\n\n\n\n

      Your current paywall logic will now be replicated using Access Groups and rules.<\/em><\/p>\n\n\n\n

      Build Matching Access Groups<\/strong><\/h2>\n\n\n\n

      Recreate your previous gating logic:<\/p>\n\n\n\n

        \n
      1. Go to Learndash App > Access Controls > Access Groups<\/strong>.
        <\/li>\n<\/ol>\n\n\n
        \n
        \"Screenshot<\/figure><\/div>\n\n\n
          \n
        1. Click Add Group<\/strong>.
          <\/li>\n<\/ol>\n\n\n\n
          \"Screenshot<\/figure>\n\n\n\n
            \n
          1. Select the matching condition:
            <\/li>\n\n\n\n
          2. Click Save Group<\/strong>.
            <\/li>\n\n\n\n
          3. Repeat for each membership or course previously required for access.
            <\/li>\n<\/ol>\n\n\n\n

            Restrict App Login via General Access Rule<\/strong><\/h2>\n\n\n\n

            Now restrict app access based on your new groups:<\/p>\n\n\n\n

              \n
            1. Go to Learndash App > Access Controls > General<\/strong>.
              <\/li>\n\n\n\n
            2. Check Restrict Access<\/strong> to require login.
              <\/li>\n\n\n\n
            3. Under Access Groups<\/strong>, select the group(s) you created.
              <\/li>\n\n\n\n
            4. Choose a Restricted Action<\/strong>:
              \n
                \n
              • Show Product Screen<\/strong>
                <\/strong><\/li>\n\n\n\n
              • Return to Login<\/strong>
                <\/strong><\/li>\n\n\n\n
              • Open App Page<\/strong> (e.g., a custom \u201cNeed Access?\u201d screen)
                <\/li>\n<\/ul>\n<\/li>\n\n\n\n
              • Click Save Changes<\/strong>.
                <\/li>\n<\/ol>\n\n\n\n
                \"screenshot<\/figure>\n\n\n\n

                To lock the entire app to logged-in users, enable <\/em>Private App<\/em><\/strong> under <\/em>Learndash App > Settings > General > Privacy<\/em><\/strong>. This hides all content until login or registration.<\/em><\/p>\n\n\n\n

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

                Q: My old paywall isn\u2019t showing after migration.<\/strong>
                <\/strong> A:<\/strong> Double-check that every gated item has a corresponding Access Group and that those groups are selected in the General<\/strong> rule.<\/p>\n\n\n\n

                Q: I don\u2019t see my membership plugin under Access Groups.<\/strong>
                <\/strong> A:<\/strong> Make sure the plugin (e.g., MemberPress, Restrict Content Pro) is installed and active.<\/p>\n\n\n\n

                Q: Can I show a custom page when users are blocked?<\/strong>
                <\/strong> A:<\/strong> Yes. Create an App Page and choose Open App Page<\/strong> in your General rule to show it to restricted users.<\/p>\n\n\n\n

                Q: Can I now gate specific pages, posts, or courses?<\/strong>
                <\/strong> A:<\/strong> Absolutely. After setting up your general login rule, use additional rules under App Pages<\/strong>, Pages<\/strong>, Posts<\/strong>, or Courses<\/strong> to target individual content.<\/p>\n","protected":false},"excerpt":{"rendered":"

                Introduction The Require Purchase setting allows you to restrict your entire app behind a single paywall. With Access Controls, you now gain the flexibility to set up granular, rule-based restrictions using memberships, courses, or custom logic. This guide shows you how to migrate your Require Purchase setup to the new Access Controls system using Access…<\/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":[287],"doc_tag":[],"knowledge_base":[283],"class_list":["post-10410","docs","type-docs","status-publish","hentry","doc_category-advanced-learndash-app","knowledge_base-learndash-app"],"year_month":"2026-04","word_count":428,"total_views":"883","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":"Advanced for the Learndash App","term_url":"https:\/\/learndash.com\/support\/kb\/learndash-app\/advanced-learndash-app\/"}],"doc_tag_info":[],"taxonomy_info":{"doc_category":[{"value":287,"label":"Advanced for the Learndash App"}],"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\/10410","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=10410"}],"version-history":[{"count":3,"href":"https:\/\/learndash.com\/support\/wp-json\/wp\/v2\/docs\/10410\/revisions"}],"predecessor-version":[{"id":10685,"href":"https:\/\/learndash.com\/support\/wp-json\/wp\/v2\/docs\/10410\/revisions\/10685"}],"wp:attachment":[{"href":"https:\/\/learndash.com\/support\/wp-json\/wp\/v2\/media?parent=10410"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/learndash.com\/support\/wp-json\/wp\/v2\/doc_category?post=10410"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/learndash.com\/support\/wp-json\/wp\/v2\/doc_tag?post=10410"},{"taxonomy":"knowledge_base","embeddable":true,"href":"https:\/\/learndash.com\/support\/wp-json\/wp\/v2\/knowledge_base?post=10410"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}