Installing RechargeSMS
RechargeSMS is a transactional SMS tool that empowers customers to manage their subscriptions by text message.
This guide provides instructions for installing RechargeSMS, navigating through the onboarding guide, and activating the integration.
- Shopify Checkout Integration
- Migrated Shopify Checkout
Before you start
- At this time, RechargeSMS is only compatible with phone numbers originating from the United States and Canada (with a +1 country code). Subscribe to the Recharge Changelog to receive notifications of new feature releases and updates.
- Due to US laws and legislation, RechargeSMS cannot support stores selling products containing cannabidiol (CBD).
Step 1 - Install RechargeSMS
Install RechargeSMS from the Recharge merchant portal to start using the integration:
- From the Recharge merchant portal, click Apps and select Marketplace from the dropdown list.
- Locate RechargeSMS and click Get.
- On the following screen, click Enable.
Step 2 - Complete the onboarding guide
After installing RechargeSMS, the integration automatically launches in a new window or tab. Use the onboarding guide to get started:
- Click Continue on the onboarding guide to launch the setup wizard.
- The onboarding guide walks you through enabling Recommended Features, configuring settings, using the Messaging Simulator, and adding products to RechargeSMS.
- After completing the onboarding guide, click Proceed to Activation Step.
-
On the launch screen, click Enable to install the RechargeSMS Cart Widget Opt-in on your store's cart page. Enabling the Cart Widget Opt-in allows all future subscribers to opt-in to the SMS service. For more information on the Cart Widget Opt-in see Enable RechargeSMS opt-in.
- Click Launch to finish setting up RechargeSMS. If you are not ready to launch RechargeSMS at this time, click I'd like to test.
After launching, the page may take a few seconds to refresh. Click on the messaging status indicator and verify Future Subscribers and RechargeSMS Service are toggled on. To enable RechargeSMS for current subscribers, see Enable Cart Widget Opt-in.
Step 3 - Enable RechargeSMS Opt-in
Customers must opt-in to receive SMS messages. Customers opt-in from the cart.
Review the following opt-in methods to enable opt-in for your customers:
Capturing opt-in for future subscribers
You must update your Shopify checkout settings to capture customers' phone numbers:
- Open your Shopify admin and click Settings.
- Select Checkout and set the Shipping address phone number to Optional or Required.
- Click Save.
There are several different ways to capture opt-in from the cart for Shopify Checkout Integration stores. If you are a Shopify Plus merchant, see Manually installing Opt-in on Shopify Plus.
Enable Cart Widget Opt-in
The Cart Widget Opt-in allows customers to opt-in to RechargeSMS from the cart. To enable opt-in from the cart:
- From the RechargeSMS My Shop page, locate the Opt-in Tools section.
- Under New Subscriber Flow, click Set up your SMS Opt-in Widget.
- Toggle on the Enable Cart Widget Opt-in option. This may already be toggled on if you enabled the Cart Widget Opt-in during onboarding.
- (Optional) Click Don't like how it looks? Customize it! to change the appearance of the widget on the cart page.
It can take up to 30 seconds for the Cart Widget Opt-in to appear on your store's cart page. If the Cart Opt-in widget is not available after completing these steps, see Manually install the Cart Widget Opt-in.
Manually install the Cart Widget Opt-in
RechargeSMS automatically injects the Cart Widget Opt-in code into your Shopify theme. Depending on your store setup or theme, you may need to manually install the widget:
- Enable the Cart Widget Opt-in feature.
- Click Don't like how it looks? Customize it! and select Manually install instead?
- Use the customization options to style the widget.
- Select Copy </> in the Widget HTML section to copy the code.
- Click Configure Shopify theme to open the Themes page of your Shopify store.
- On your current store theme, click Actions and select Edit code.
- Locate the cart file. This is typically the
cart-template.liquid
or themain-cart-footer.liquid
file depending on your store's theme. - Paste the copied code from Step 4 after the Subtotal element.
- Add
<div id="rcsms-cart-widget"></div>
to the Subtotal element in the cart. This places the opt-in widget above the check out button in the cart. - Click Save.
- Preview the cart page on your storefront to confirm the widget is available.
Manually install Opt-in on Shopify Plus
Merchants using the Shopify Checkout Integration on Shopify Plus can manually add the opt-in script to checkout. Adding scripts to the checkout requires Shopify Plus.
To manually add the opt-in script:
- Enable SMS Marketing in the Shopify Admin checkout settings. This allows the script to function.
- In the Shopify admin, click Online Store and select Themes.
- Click Customize on your live theme.
- In the theme editor, click the Home page dropdown to select the Checkout and new customer accounts page.
- Add the Recharge SMS Opt-in app block to the desired location on the page.
- If the app block is not available and RechargeSMS is installed, contact Recharge Support.
Recharge Support cannot assist with making customizations to your storefront or checkout per Recharge's design and integration policy. If you need assistance with making customizations, contact your store’s theme developer or work with a third-party developer.
Capturing opt-in for current subscribers
If you have existing subscribers that you would like to capture opt-in for, you can easily turn this option on for them. Once enabled, the customer will be given the option to opt-in to receive SMS messages.
- In the RechargeSMS dashboard, click the Messaging status indicator.
- Use the toggle to enable Current Subscribers.
- Use the toggle to enable SMS service.
- Click Close.
Landing page opt-in widget
The landing page opt-in widget allows customers to opt-in from a custom landing page instead of the cart or checkout pages. This opt-in method is optional, but it allows customers to opt-in to RechargeSMS outside of the checkout flow and increases the chances of customer opt-in.
Step 1 - Enable and customize the widget
- Open RechargeSMS and navigate to the My Shop page.
- Locate the Landing Page Opt-in section and click Create your Opt-in Landing Page.
- Enter your store name, logo, and color branding in the Shop Branding fields.
- Click Save styles to set your configuration.
- Under Promo Copy, adjust the font color and verbiage used on the widget.
- Under Call to Action, adjust the styling and verbiage of the Call to Action (CTA) button.
- Verify the customizations on the widget preview.
Step 2 - Add the widget code to your Shopify theme
- On the landing page opt-in widget page, select Save and Generate.
- Select Copy </> to copy the widget code to your clipboard.
- Follow the instructions provided to access your store’s Shopify Pages editor.
- Select Add Page and title it Subscription Management via Text.
- Select <> to open the HTML editor.
- Paste the RechargeSMS widget code from Step 2 into the HTML editor and click Save.
- Select More actions and click View page to preview the opt-in widget on your storefront. You can modify the HTML or CSS code in the page editor to improve the appearance of the widget.
Once installed, share the link to the landing page opt-in widget with your customers through an email campaign, or use a pop-up app like Privy to promote the page to customers who visit your storefront.
If you make changes to your landing page widget at any time, these changes will not update with Shopify. If you make changes, you must replace the code in your Shopify theme with the new code.
Preview the landing page opt-in customer experience
The landing page opt-in prompts customers to enter the email address and phone number associated with their Recharge account.
After filling in the landing page opt-in details, the customer receives an SMS message with a verification code. The customer enters this verification code into the opt-in widget.
After the widget validates the verification code, customers receive a verification email. From the verification email, the customer must click Verify Number to proceed. After clicking Verify Number, the customer is redirected to a confirmation page.
Step 4 - Optional - Connect a customer support integration
RechargeSMS integrates with a number of customer support integrations:
- Freshdesk
- Intercom
- Gorgias - Gorgias is a preferred customer support integration for RechargeSMS. In addition to email support, Gorgias allows agents to respond directly to customers via SMS. This is possible with the use of Gorgias's built-in SMS widget.
- Kustomer
- Re:amaze
- Zendesk
For more information on connecting a customer support integration, see Using customer support integrations with RechargeSMS.
Testing RechargeSMS
After installing RechargeSMS and configuring opt-in methods, you may want to test the service. For instructions on testing the service, see Testing RechargeSMS.