Shopify Afterpay On-Site Messaging App

Important
You cannot use the Afterpay On-site Messaging App to add Cash App Afterpay at checkout. Instead, follow the instructions on the Add Afterpay at Checkout page.
Important
Before you install and configure the Afterpay On-Site Messaging App, make sure you already added Cash App Afterpay at checkout on your Shopify store. Ensure Cash App Afterpay is visible at checkout and functioning before you attempt anything with the Afterpay On-Site Messaging App. You cannot use the Afterpay On-Site Messaging App without first adding Cash App Afterpay at checkout successfully.
This page shows you how to do the following:

This information is for Shopify 2.0 themes only.

Install the Afterpay On-site Messaging App

Do the following:

  1. Click the link to download and install the Afterpay On-Site Messaging app from the Shopify App Store.

  2. Click Install. An installation screen on Shopify’s admin portal appears.

    shop-app-install-A.png

  3. Click Install.

    shop-app-install-B.png

    If you clicked Install and your screen doesn’t show the Connect button, your Cash App Afterpay account is already fully registered. You can skip steps 4 to 7 (inclusive) below and go straight to the Add the Messaging to the Product Pages section.
  4. Click Connect next to Connect the Cash App Afterpay account. You are taken to a get.afterpay.com URL, where the email is prefilled with the email on your Shopify store.

    shop-app-install-C.png

  5. Send the email and Cash App Afterpay will email you a login link to the Cash App Afterpay dashboard.

    shop-app-install-D.png

  6. Login to your Cash App Afterpay dashboard and ensure you have completed all the registration steps.

  7. When Cash App Afterpay registration is complete, click the Show me how button under Add Afterpay messaging, at the bottom of the get.afterpay.com status page.

    step-7-small.png

Add the Messaging to the Product Pages

  1. Once it is installed, you need to open the Afterpay On-Site Messaging app. To do this, go to Shopify Admin. Then go to Apps and select Afterpay On-Site Messaging.

    shop-message-app-1.png

  2. From the app’s Add Messaging section, click Open Theme Editor.

    shop-message-app-2.png

  3. From the Theme editor, click the dropdown at the top of the editor, then click Products.

    shop-message-app-3.png

  4. Select the Default product template, or the Product template that needs messaging.

    shop-message-app-4.png

    How Messaging Works

    Messaging works on Product Page templates. So if you have a single Product Page template, you add messaging to that template. If you have several different Product Page templates, then you’ll need to add messaging to each one separately.

  5. Move your mouse over the Product price, a + symbol appears.

    ![Shopify OSM App - Product Pages - Step 5.png](../../../assets/images/Shopify OSM App - Product Pages - Step 5.png)

  6. Click Add block and then select Payments Messaging - Afterpay On-Site Messaging.

    Your product page should now look like this:

    ![Shopify OSM App - Product Page Example.png](../../../assets/images/Shopify OSM App - Product Page Example.png)

  7. Click Save in the top right corner.

    shop-message-app-9.png

Add the Messaging to the Cart Page

Never try to use the app to add Cash App Afterpay to the checkout page.
You are now ready to add some messaging to the Cart page. Do the following:

  1. For an accurate Cart page preview, click Add to cart.

    ![Shopify OSM App - Product Pages - Step 7 screenshot 2 (alt).png](../../../assets/images/Shopify OSM App - Product Pages - Step 7 screenshot 2 (alt)-2.png)

  2. Next, to open the Cart page, click the dropdown at the top of the editor and click Cart.

    shop-message-app-b.png

  3. Move the mouse over the Subtotal above the Checkout button. A + symbol appears.

    ![Shopify OSM App - Cart Page - Step 3 to 5.png](../../../assets/images/Shopify OSM App - Cart Page - Step 3 to 5.png)

  4. Click Add Block and select Afterpay On-Site Messaging.

  5. If the text alignment is wrong, adjust the text alignment. To do this, click the Text Alignment dropdown and select a new alignment option.

    ![Shopify OSM App - Cart Page - Step 6.png](../../../assets/images/Shopify OSM App - Cart Page - Step 6.png)

Mobile View

You can set a separate alignment for display on mobile devices.

Do the following:

  1. To check the appearance on a mobile device, click the monitor icon and then click Mobile at the top right of the editor.

    shop-message-app-mobile.png

  2. Scroll down to Mobile View settings, make any changes you need.

  3. Click Save in the top right corner.

  4. Verify your messaging and alignment on your live store.

You can adjust various aspects of the page for mobile devices. See the Mobile View Adjustments section below for more details.

Adjust the Style of Messaging

You can adjust many aspects of the styling. To do this:

  1. Select the Payments Messaging - Afterpay On-Site Messaging block on the Product page.

    ![Shopify OSM App - Style Messaging - Step 1.png](../../../assets/images/Shopify OSM App - Style Messaging - Step 1.png)

    Alternatively you can select Payments Messaging - Afterpay On-Site Messaging from the side bar under Product information. See picture below:

    shop-message-app-adjust-2.png

Text Alignment

To adjust the text alignment:

  1. Click the Text Alignment dropdown and select a new alignment option.

    ![Shopify OSM App - Text Alignment - Screenshot 1.png](../../../assets/images/Shopify OSM App - Text Alignment - Screenshot 1.png)

Margins

To adjust the margins above and below the messaging:

  1. Enter a new value into the Margin Top field.

  2. Enter a new value into the Margin Bottom field.



    Negative values are allowed.

    ![Shopify OSM App - Margins - Screenshot 1.png](../../../assets/images/Shopify OSM App - Margins - Screenshot 1-2.png)

Text Color

To adjust the text color:

  1. Click the Text Color color-picker and select the new text color.

    ![Shopify OSM App - Text Color - Screenshot 1.png](../../../assets/images/Shopify OSM App - Text Color - Screenshot 1-2.png)

Text Size

To adjust the text size:

  1. Click the Text Size dropdown and select a new text size option, extra small, small, medium and large.

    ![Shopify OSM App - Text Size - Screenshot 1.png](../../../assets/images/Shopify OSM App - Text Size - Screenshot 1.png)

Text

To adjust the intro text:

  1. Click the *Intro Text dropdown and select a new intro text option.

    ![Shopify OSM App - Intro Text - Screenshot 1.png](../../../assets/images/Shopify OSM App - Intro Text - Screenshot 1.png)

Show/Hide “Interest Free”

To show or hide the interest-free phrase:

  1. Enable or disable the Show “interest-free” checkbox.

    ![Shopify OSM App - Show Interest Free - Screenshot 1.png](../../../assets/images/Shopify OSM App - Show Interest Free - Screenshot 1.png)

The default value is enabled - the phrase interest-free appears to your customers. In the picture above, the checkbox is blank, so no interest-free message appears to your customers.

Payment Amount

To show or hide the payment amount in bold:

  1. Enable or disable the Bold Payment Amount checkbox.

    ![Shopify OSM App - Bold Amount - Screenshot 1.png](../../../assets/images/Shopify OSM App - Bold Amount - Screenshot 1.png)

The default value is enabled - the payment amount is in bold. In the picture above, the checkbox is blank, so the payment amount does not appear in bold to your customers.

Show/hide “with”

The word “with” appears between the price and the Cash App Afterpay logo or badge. See the Logo Type below. To show or hide the word “with” do the following:

  1. Enable or disable the Show “with” checkbox.

    ![Shopify OSM App - Show With - Screenshot 1.png](../../../assets/images/Shopify OSM App - Show With - Screenshot 1.png)

The default value is enabled - the word “with” appears between the price and the Cash App Afterpay logo or badge. In the picture above, the checkbox is blank, so the word with does not appear to your customers.

Logo Type

To set the logo type:

  1. Click the Logo Theme dropdown and select a new logo type.

    ![Shopify OSM App - Logo Type - Screenshot 1.png](../../../assets/images/Shopify OSM App - Logo Type - Screenshot 1.png)

Logo Theme

To set the theme of the logo:

  1. Click the Logo Theme dropdown and select the new logo theme you want.

    ![Shopify OSM App - Logo Theme - Screenshot 1.png](../../../assets/images/Shopify OSM App - Logo Theme - Screenshot 1.png)

When a customer clicks on the modal link, a pop-up window appears with more information about Cash App Afterpay. The default symbol for the modal link is a circled info icon ⓘ.

To change or hide the modal link:

  1. Click the Modal Link Style dropdown and select the new modal link option.

    ![Shopify OSM App - Modal Link - Screenshot 1.png](../../../assets/images/Shopify OSM App - Modal Link - Screenshot 1.png)

Outside Order Limits Messaging

The outside order limits messaging is a message displayed when the product price is outside the limits for Cash App Afterpay.

The default for these limits is 1.001.00 - 4,000.00 at present.

To adjust the outside order limits messaging:

  1. Disable the Show Lower Limit checkbox to hide the lower limit.

  2. Disable the Show Upper Limit checkbox to hide the upper limit.

  3. Disable the Show If Outside Limits checkbox to hide outside order limits messaging completely.

    ![Shopify OSM App - Order Limits - Screenshot 1.png](../../../assets/images/Shopify OSM App - Order Limits - Screenshot 1.png)

Remember that the above settings only affect the messaging the customer sees. The settings do not affect whether customers can buy products at the checkout.

Mobile View Adjustments

You can set the styling separately for customers on mobile devices. To set the styling for mobile devices, do the following:

  1. Click the monitor icon near the Save button.

  2. Click the Mobile button that appears.

    mobile-set-mobile.png

Breakpoint

To adjust the screen width that defines the mobile view:

  1. In the Breakpoint field, enter a new number in pixels.

    ![Shopify OSM App - Mobile Breakpoints - Screenshot 1.png](../../../assets/images/Shopify OSM App - Mobile Breakpoints - Screenshot 1.png)

Text Alignment

To adjust the text alignment for a mobile view:

  1. Click the Text Alignment dropdown and select a new alignment option.

    ![Shopify OSM App - Mobile Text Alignment - Screenshot 1.png](../../../assets/images/Shopify OSM App - Mobile Text Alignment - Screenshot 1.png)

Margins

To adjust the margins above and below the messaging on a mobile view:

  1. Enter a new number, this can be a negative number, into the Margin Top or Margin Bottom fields.

    ![Shopify OSM App - Mobile Margins - Screenshot 1.png](../../../assets/images/Shopify OSM App - Mobile Margins - Screenshot 1.png)

To place a payment icon on the footer (bottom) of the payment page, see the Footer Payment Icon section in the Shopify FAQ

Hide Messaging from Some Products

When you have enabled the On-Site Messaging App, you can also hide Afterpay Messaging from certain products. To do this, use the Theme Editor to create a new template. Next you go to the Product section and choose the products that you don’t want associated with messaging. Then you assign these selected product(s) to the new template and make sure no messaging is applied to that template.

To create the template:

  1. Go to the On-Site Messaging App.

  2. Open the Theme Editor.

  3. Click the Home Page dropdown, and then select Products. See the picture below:

    hide-message-new-1.png

  4. Select Create Template.

  5. Enter a name for this new template. See the picture below:

    hide-message-3-new.png

You have now created your template and named it. Your next task is to fill this template with the product, or products, that you don’t want to have Afterpay messaging.

Do the following:

  1. Go to Shopify admin and select Products.

  2. Use the Search filter to find the product that you don’t want to associate with Afterpay messaging. You can also find this product from the list of existing products. See the picture below:

    hide-message-4-new.png

  3. In the Online store section, open the drop-down menu and select the new theme template you created. Then apply this new template to the product. See picture below:

    hide-message-5-new.png

  4. Repeat step 3 for all the products that you don’t want to associate with Afterpay messaging. Click Save when you have finished

  5. Go back to On-Site Messaging App and open the Theme Editor.

  6. Select the new template, then click Afterpay Messaging and delete it.

The Afterpay messaging for all the products assigned to the template is deleted.