How to install GO SUB code

You can watch without sound by turning on YouTube captions

Go Sub Tutorial Video List

How to install an Online Store 2.0 compatible theme

If you use the app block, the code will be updated automatically.
Also, when you delete the app, the code is automatically removed from the theme.

The related article provides detailed step-by-step instructions.
If you are having trouble installing the theme, please read this.

[GO SUB Tips] Detailed explanation of how to insert GoSub blocks into themes and how to use them with older themes!

Adding an app block to a product page

Click "Install Theme" > "Select Theme" > "Open Product Page in Theme Editor"
Click Add Block > Go Sub Block
Drag and drop the app block to move it to the desired position. 

Adding an App Block to Your Account Page

The installation method varies depending on the type of account you have.
Please check which option is selected in Shopify > Settings > Customer Account.

For "Customer Account"

Check out Add Blocks from the Customizer.
Go to Shopify > Settings > Checkout and click Customize.

On the order screen, add a block.

Nothing will be displayed in the preview, but that's OK.

Similarly, you can add the block to your order status page.
Add it using the same procedure as above.

[GO SUB Tips] Supporting New Customer Accounts! How to Add a Subscription Management Button to the Order Details Page

Hiding the repurchase button

If the repurchase button display is turned on, unintended orders may occur.
Even if you click the repurchase button from your subscription order history, a subscription will not be created. To avoid confusion, be sure to turn off the repurchase button in the checkout customizer.

For existing customer accounts

If your customer account settings are set to "Previous Version", insert the GO SUB block from the Theme Customizer.
Go to Online Store > Customization and select Customer Accounts under Traditional Customer Accounts.

*The next screen will ask you to log in. Create a temporary account, log in on the customizer, and proceed to the next screen.

Insert the GO SUB app block into your account page.

Adding an app block to the cart page (optional)

There are two types of blocks that can be added to the cart page.This is intended to prevent unintended changes or purchases, and its installation is optional.

Cart operation control when selling subscription boxes

A subscription box only becomes a single contract when all the products are bundled together. If customers freely change or delete products on the cart screen, it may result in unintended sales (such as selling for 0 yen or failing to meet the box requirements), so please use the blocks to control operations as needed.

Click here for details on controlling shopping cart operations when selling subscription boxes.

Alert display when subscription plans are mixed.

When payments are made for multiple subscription plans, under the following conditions, separate contracts may be merged into one, potentially resulting in unintended discounts or other errors. While contract merging is determined by Shopify's specifications, it can be controlled using app blocks.

[Examples regarding contract consolidation]

  • Order cycle is the same (e.g., once every 30 days, once a week)
  • The minimum and maximum number of purchases are the same.

Example 1: Purchase product A under plan ① + purchase product B under plan ②

  • Plans 1 and 2Both once every 30 days
  • No minimum or maximum purchase frequency settings.
  • (Plan 1 offers a 30% discount, while Plan 2 offers a 50% initial discount followed by a 10% discount thereafter.)

in this case,The subscription agreements for products A and B have been merged.As a result, the discount rate of Plan 1 is applied to everything, and the original discount rate is not applied, resulting in an error.

 

Example 2:Purchase product A with plan ① + purchase product B with plan ②

  • Plan 1 is once every 30 days, Plan 2 is once every 60 days.
  • No minimum or maximum purchase frequency settings.
  • Plan 1 offers a 30% discount, while Plan 2 offers a 50% initial discount followed by a 10% discount thereafter.

In this case, the plans will not be merged, and a separate contract will be created, which will be the correct procedure.


If you need to prevent unintended contract mergers like in Example 1, add "Plan Alert Block" to your cart page.

This will display an alert like the one below. The displayed text can be changed in the app management screen under Settings > Translation, Change Text.

If you want to display the alert but still allow the checkout process, uncheck this box in the app blocking settings.

Notes on Quick Add (we recommend turning it off)

If quick add to cart from product card is turned on,Subscription plans do not apply and regular saleswill be treated as
To prevent unexpected sales,Quick Add feature is turned offWe recommend that you do so.

For advanced customization engineers

If you want to require the Quick Add feature, add the "GO SUB Quick Add block" to your theme's index template or collection template and take the following steps.

  • If a subscription plan exists, go to the product page instead of quick add (edit Liquid code)
  • Customize the quick view modal (editing Liquid code and JavaScript)

Please also check the "Notice regarding buttons such as 'Buy Now,' 'Quick Add,' and 'Rebuy'" in App Management > Theme Installation.

Themes not compatible with Online Store 2.0  

Because it is difficult to keep up with app updates,We recommend using a theme compatible with OS 2.0.We are doing so.
If installation is required for an unsupported theme,Application FormPlease fill in the required information to apply.

How to check if the theme is compatible with Online Street Fighter 2.0

Click [Online Store] > [Themes] > [...] > [Edit Code]
Check the Template
Extension is .json => OS2.0 compatible
The extension is .liquid => OS2.0 not supported