Skip to main content

General

Widget placement, app language, recurring invoices, etc.

Written by Andrey Gadashevich

Here’s what users can do in RecurrinGO → Settings → General:

Access these settings by navigating to RecurrinGO → Settings → General:

1. Set up selectors (where the app injects widgets & what buttons it tracks)

Recommended for the product page widget: use the app block. If your theme is Online Store 2.0, add the Subscription Widget block in Online Store → Themes → Customize instead of using a selector. See How to add the subscription widget to your product page. Use the selectors below for vintage themes, or when the block can't be placed where you need it.

Selectors tell RecurrinGO where to insert its widgets and which buttons, prices, and subtotals to hook into.

Before you start: how the “Select” picker works

Anywhere you see a Select button:

  1. Click Select → a new tab opens on the relevant page (product page, cart, quick view, account page, etc.).

  2. Hover elements to see outlines, then hold Shift and click the element you want.

  3. Choose Above/Below to place the widget relative to that element.

  4. Click Save (or Clear to start over), then return to the app tab.

Prefer code? Click Advanced mode under any control to paste a CSS selector.

Basic and Advanced mode

  • Basic (toggle OFF): visual, point-and-click placement.

  • Advanced (toggle ON): adds extra selector options and lets you paste a CSS selector manually under any control. Example: form[action^="/cart/add"] [type=submit]

A. Widget placement on a product page

Alternative to the app block (vintage themes, or if the block can't be placed where you need it).

  • Basic: Select → Shift-click an element near the title, price, or Add to cart → Above/Below → Save.

  • Advanced: Paste a CSS selector for that element.

If the Subscription Widget app block is already on your product page, this row shows "Widget placement is managed through the Theme editor" instead of a picker. The block takes priority.

B. “Add to cart” button selection

Bind the exact Add to cart button so RecurrinGO adds the correct selling plan when customers add products.

  • Basic: Change/Select → Shift-click the button → Save.

  • Advanced: Paste the selector (the example above fits many themes).

C. Cart upsell widget placement (Desktop)

Choose where the upsell widget appears on the /cart page for desktop layouts.

  • Basic/Advanced as above.

D. Cart upsell widget placement (Mobile)

Choose the upsell position for mobile cart layouts (often a different anchor).

1.1. Extra options when Advanced mode is ON

These help RecurrinGO replace old prices and totals with subscription (often discounted) values and place widgets in more theme areas.

A. Product price selection

If a subscription product is discounted, replace the old product price on the product page with the discounted one. Select the price element (or paste a selector).

B. Cart subtotal selection (cart page)

Replace the cart subtotal on the standard /cart page with the discounted subtotal when subscription items are present. Select the subtotal element (or paste a selector).

C. Widget placement on a Quick view

Show the subscription widget inside your theme's quick-view modal/card. Open a product's quick view → Select the anchor → Save.

D. Widget placement on the Featured product section

Place the widget inside your homepage "Featured product" section. Make sure at least one active product is shown → Select the anchor → Save.

E. “Manage subscriptions” button – custom placement

Move the customer Manage subscriptions button to a different spot on the account page. Log in as a customer → Select → Shift-click your preferred location → Save.

2. Ajax / cart drawer settings

Some themes use a cart drawer or pop-up instead of a full /cart page.

Check Current store theme has Ajax Cart / pop-up cart / cart drawer if your theme uses a drawer. When checked, two drawer-specific selectors appear:

  • 'Check out' button selection (drawer) – Select the drawer's Checkout button.

  • Cart subtotal selection (drawer) – Select the subtotal inside the drawer so RecurrinGO can replace it with the discounted total.

When not checked, these drawer controls are hidden. Use the standard /cart selectors instead.

3. Pricing for recurring invoices (not auto-charge)

Choose how renewal prices are determined for invoice-based subscriptions:

  • Use actual product prices from the store – Renewals always follow your current storefront price. Not editable on the subscription page.

  • Use product prices from the subscription – Renewals keep the initial order price. Editable later on the subscription page.

Pick "actual prices" if you want renewals to track catalog changes. Pick "subscription prices" if you promise locked-in rates or manage renewals per customer.

4. Additional settings

  • Tag name – Order tag applied to subscription orders in Shopify admin (e.g., subscription).

  • Cart label – Small label shown by many themes near the frequency (e.g., "Delivery frequency").

  • Enable 'Subscribe' option by default – Preselects Subscribe on the product page.

  • Replace "Add to cart" text when a subscription is selected – Enter custom button text (e.g., "Add subscription to cart").

5. Custom CSS and JS

You can customize your subscription widgets with greater flexibility and quickly implement any customizations you want with custom CSS and JS.

6. App language (admin only)

Change the RecurrinGO admin UI language (English, French, German, Spanish). This does not change storefront translations.

Troubleshooting & FAQs

👉 I see "Selection required".
Open Select again → Shift-click the element → Save in the picker tab.

👉 The picker isn't opening.
Allow pop-ups for Shopify, and temporarily disable ad-blockers or browser extensions.

👉 The Save button in the picker doesn't become active.
You need to Shift-click an element and choose Above or Below first. If your theme supports app blocks, skip the picker and add the Subscription Widget block in the theme editor instead. See How to add the subscription widget to your product page.

👉 The widget doesn't show on product pages.

  1. Make sure the RecurrinGO! app embed is on (Customize → App embeds).

  2. On Online Store 2.0 themes, check that the Subscription Widget block is in Product information.

  3. On vintage themes, re-save the product page placement selector.

  4. Make sure the product is in an enabled subscription rule.

👉 Totals don't update in the cart drawer.
Make sure the Ajax cart box is checked and that you've selected both Checkout and Subtotal inside the drawer.

👉 We changed themes.
Placement doesn't carry over to a new theme. On Online Store 2.0 themes, add the Subscription Widget block again in the new theme. On vintage themes, set up the selectors again (they are theme-specific).

👉 Can I use code instead of clicking?
Yes. Use Advanced mode and paste a CSS selector (the app shows a working example).

Need Help?

If you have any questions or need help, please contact our support team.

📩 Contact Support: Reach out to us via live chat or send an email to [email protected]

Did this answer your question?