{"id":211645,"date":"2025-12-15T13:34:01","date_gmt":"2025-12-15T08:04:01","guid":{"rendered":"https:\/\/www.storeapps.org\/?post_type=kbe_knowledgebase&#038;p=211645"},"modified":"2025-12-15T13:34:01","modified_gmt":"2025-12-15T08:04:01","slug":"ss-settings","status":"publish","type":"kbe_knowledgebase","link":"https:\/\/www.storeapps.org\/docs\/ss-settings\/","title":{"rendered":"How to configure subscription settings"},"content":{"rendered":"<p>Access Smart Subscriptions settings by navigating to WordPress admin \u2192 WooCommerce \u2192 Settings \u2192 Smart Subscriptions.<\/p>\n<h2 id=\"general-settings\">General settings<\/h2>\n<p>Control how subscriptions work in your store and what actions customers can take.<\/p>\n<p><strong>Enable Subscriptions<\/strong> &#8211; Turn subscription functionality on or off across your entire store.<\/p>\n<p><strong>Default Billing Period<\/strong> &#8211; Choose the default billing cycle for new subscription products: Day, Week, Month, or Year. This can be changed for individual products.<\/p>\n<p><strong>Default Billing Interval<\/strong> &#8211; Set how often subscriptions renew by default (e.g., every 1 month, every 2 weeks). You can override this for each product.<\/p>\n<p><strong>Allow Customer Cancellation<\/strong> &#8211; Let customers cancel their subscriptions from their My Account page, or restrict cancellations to admin-only.<\/p>\n<p><strong>Allow Customer Pause\/Resume<\/strong> &#8211; Give customers the flexibility to pause and resume their subscriptions whenever they need a break.<\/p>\n<p><strong>My Account Page Title<\/strong> &#8211; Customize what customers see in their account dashboard. The default is &#8220;My Subscriptions&#8221;, but you can change it to match your brand voice.<\/p>\n<h2 id=\"email-settings\">Email settings<\/h2>\n<p>Automated email notifications keep customers informed about their recurring payments and subscription status changes.<\/p>\n<p><strong>Enable Email Notifications<\/strong> &#8211; Master switch for all subscription emails. Turn this off to disable all automated subscription notifications.<\/p>\n<p><strong>Admin Email Recipients<\/strong> &#8211; Enter the email addresses that should receive admin notifications (like new subscriptions or cancellations). Use commas to separate multiple addresses.<\/p>\n<p><strong>Send Customer Emails<\/strong> &#8211; Notify customers about important subscription events like renewals, cancellations, and payment issues.<\/p>\n<p><strong>Send Admin Emails<\/strong> &#8211; Keep your team in the loop with admin notifications for subscription activity.<\/p>\n<p><strong>Customize Email Templates<\/strong> &#8211; Want to further customize emails? Copy email templates to your theme&#8217;s <code>\/woocommerce\/emails\/smart-subscriptions\/<\/code> directory and customize them however you like.<\/p>\n<p><strong>Test Email<\/strong> &#8211; Before going live, send yourself a test email to make sure everything looks perfect. Choose from different email types (Subscription Created, Renewed, Cancelled, Paused, or Payment Failed) and send it to any email address.<\/p>\n<p>No need to save settings first &#8211; the test function works immediately, making it easy to iterate on your email setup.<\/p>\n<h2 id=\"payment-settings\">Payment settings<\/h2>\n<p>Set up intelligent payment retry logic to recover failed payments and maximize your recurring revenue.<\/p>\n<h3>Retry failed payments<\/h3>\n<p>Sometimes payment methods fail temporarily &#8211; a card might be at its limit, or a bank might flag a transaction. Instead of losing that customer immediately, Smart Subscriptions automatically retries failed payments to give the transaction another chance to succeed.<\/p>\n<p><strong>Payment Retry Attempts<\/strong> &#8211; Choose how many times to retry before giving up (1-100 attempts). The default is 4 attempts, which balances persistence with not annoying customers.<\/p>\n<p><strong>Retry Schedule<\/strong> &#8211; Configure when each retry happens:<\/p>\n<ul>\n<li><strong>First Retry:<\/strong> Wait 12 hours (default) before trying again<\/li>\n<li><strong>Second Retry:<\/strong> Wait 24 hours (default) after the first retry<\/li>\n<li><strong>Third Retry:<\/strong> Wait 48 hours (default) after the second retry<\/li>\n<li><strong>Fourth Retry:<\/strong> Wait 72 hours (default) after the third retry<\/li>\n<\/ul>\n<p>You can adjust these timing intervals anywhere from 1 to 168 hours to match your business needs.<\/p>\n<p><strong>Subscription Revenue Recovery Tip:<\/strong> Most successful retries happen in the first 24-48 hours. The default schedule is optimized based on payment processing data.<\/p>\n<h3>Failed payment handling<\/h3>\n<p><strong>Auto-Cancel After Failed Retries<\/strong> &#8211; When all retry attempts fail, automatically cancel the subscription and notify the customer. Turn this off if you prefer to handle failed subscriptions manually.<\/p>\n<h3>Stripe integration<\/h3>\n<p>Smart Subscriptions integrates with the <a href=\"https:\/\/woocommerce.com\/document\/stripe\/\" rel=\"noopener\">WooCommerce Stripe Gateway<\/a> to securely process automatic recurring payments. Stripe handles payment method tokenization, PCI compliance, and automatic charging for subscription renewals.<\/p>\n<h2 id=advanced-settings\">Advanced settings<\/h2>\n<p>Developer and system administrator options for fine-tuning plugin behavior.<\/p>\n<p><strong>Enable Logging<\/strong> &#8211; Track subscription events and debug information. Helpful for troubleshooting issues or monitoring subscription activity.<\/p>\n<p><strong>Log Retention Period<\/strong> &#8211; Choose how long to keep logs (0-3650 days). Set to 0 for unlimited retention, or choose a shorter period like 365 days to keep your database lean.<\/p>\n<p><strong>Cron Processing Batch Size<\/strong> &#8211; Control how many subscriptions are processed per scheduled task (1-500). Lower numbers reduce server load but take longer to process all subscriptions. The default of 50 works well for most stores.<\/p>\n<p><strong>Enable REST API<\/strong> &#8211; Turn on API endpoints for external integrations, mobile apps, or custom integrations with other systems.<\/p>\n<p><strong>API Rate Limiting<\/strong> &#8211; Protect your server from abuse by limiting how many API requests can be made in a given timeframe.<\/p>\n<p><strong>Debug Mode<\/strong> &#8211; Enable detailed debugging information for troubleshooting. <strong>Warning:<\/strong> Only use this on development or staging sites, never on live production stores.<\/p>\n<p><strong>Template Override Path<\/strong> &#8211; If you&#8217;re using custom template locations, specify the path here (relative to your theme directory).<\/p>\n<h3>System information<\/h3>\n<p>View real-time system status including:<\/p>\n<ul>\n<li>Smart Subscriptions plugin version<\/li>\n<li>WooCommerce and WordPress versions<\/li>\n<li>PHP version and server configuration<\/li>\n<li>Stripe Gateway connection status<\/li>\n<li>Total subscription count (all statuses)<\/li>\n<li>Active subscription count<\/li>\n<li>Next scheduled renewal processing time<\/li>\n<li>Next scheduled payment retry time<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"<p>Learn how to configure Smart Subscriptions settings in WooCommerce. Set up recurring payments, configure email notifications, and optimize payment retry logic.<\/p>\n","protected":false},"author":5167,"featured_media":0,"comment_status":"closed","ping_status":"closed","template":"","kbe_taxonomy":[1217],"kbe_tags":[],"_links":{"self":[{"href":"https:\/\/www.storeapps.org\/wp-json\/wp\/v2\/kbe_knowledgebase\/211645"}],"collection":[{"href":"https:\/\/www.storeapps.org\/wp-json\/wp\/v2\/kbe_knowledgebase"}],"about":[{"href":"https:\/\/www.storeapps.org\/wp-json\/wp\/v2\/types\/kbe_knowledgebase"}],"author":[{"embeddable":true,"href":"https:\/\/www.storeapps.org\/wp-json\/wp\/v2\/users\/5167"}],"replies":[{"embeddable":true,"href":"https:\/\/www.storeapps.org\/wp-json\/wp\/v2\/comments?post=211645"}],"version-history":[{"count":5,"href":"https:\/\/www.storeapps.org\/wp-json\/wp\/v2\/kbe_knowledgebase\/211645\/revisions"}],"predecessor-version":[{"id":211654,"href":"https:\/\/www.storeapps.org\/wp-json\/wp\/v2\/kbe_knowledgebase\/211645\/revisions\/211654"}],"wp:attachment":[{"href":"https:\/\/www.storeapps.org\/wp-json\/wp\/v2\/media?parent=211645"}],"wp:term":[{"taxonomy":"kbe_taxonomy","embeddable":true,"href":"https:\/\/www.storeapps.org\/wp-json\/wp\/v2\/kbe_taxonomy?post=211645"},{"taxonomy":"kbe_tags","embeddable":true,"href":"https:\/\/www.storeapps.org\/wp-json\/wp\/v2\/kbe_tags?post=211645"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}