App extensions

Manage UpPromote app extensions on your Shopify theme. Enable core tracking, the message bar, customer referral widgets, and signup forms from the Theme Editor.

Understand UpPromote app extensions on your theme

App extensions help you show UpPromote features directly on your Shopify theme.

In the App extensions section in Home page, you can see which extension is currently active on your store theme and quickly go to Shopify Theme Editor to enable or manage it.

This guide explains:

• What each extension does.

• Where to configure it in UpPromote.

• What you need to do in the Shopify Theme Editor to make it appear on your storefront.

1. UpPromote essentials

What is it?

UpPromote essentials is the core tracking extension of UpPromote. It is used to support more reliable referral tracking through Web Pixel.

You do not need to configure this feature inside UpPromote first. Just enable it on your theme, following the instructions below.

How to enable it on your theme

To enable it on your theme:

1. In Shopify Admin, go to Online Store > Themes

2. Click Customize on your current live theme

3. Open App embeds

4. Find UpPromote essentials

5. Turn it on

6. Click Save

We recommend that you do NOT deactivate UpPromote essentials to ensure seamless tracking.

2. Message bar

What is it?

Message bar displays a message at the top of your store so visitors know they are shopping through an affiliate link. UpPromote’s guide explains that it appears on top of the store on every page except checkout, and you can customize the message text, font size, text color, and background color.

What do you need to configure in UpPromote?

To prepare Message bar in UpPromote:

1. Go to Displays > Message Bar

2. Edit the message settings

3. Save your changes

You can also customize the design from the Message bar settings page.

How to enable it on your theme

Message bar needs both conditions below:

1. The Message bar feature must be configured and enabled in UpPromote.

2. The Message bar app embed must be turned on in your Shopify theme.

To enable it on the theme:

1. In the App extensions section, click Activate next to Message bar.

2. The system will redirect you to the Shopify theme editor page.

3. The Message bar app embed will be enabled automatically.

4. Click Save to successfully enable the Message bar on your theme.

Learn more

For detailed setup and customization, see the Message bar guide. The official doc covers where to configure the message and how the feature behaves on storefront pages.

3. Customer referral

What is it?

Customer referral lets your customers refer friends without joining a normal affiliate program. It allows customers to promote your products and helps you grow sales through word-of-mouth.

This app embed allows you to display Widget, a floating popover on your website so customer can register for this Customer referral program via this widget.

What do you need to configure in UpPromote?

To set up Customer referral widget:

1. Go to Outreach > Affiliate recruitment > Customer referral > Set up

2. Turn on the Active option to activate Customer referral

3. In the Displays section, enable the Widget option

How to show it on your theme

To show the Customer referral widget on your storefront, you need both conditions below:

1. The Customer referral feature must be active, and the Widget display must be enabled in UpPromote.

2. The Customer referral app embed must be turned on in your Shopify theme.

To enable it on the theme:

1. In the App extensions section, click Activate next to Customer referral.

2. The system will redirect you to the Shopify theme editor page.

3. The Customer referral app embed will be enabled automatically.

4. Click Save to successfully enable the Customer referral widget on your theme.

Please note that after publishing a new theme, you need to re-enable the app embed on your theme and save to show Customer referral displays on your website.

Learn more

See the Customer referral guide to configure widget display and other feature settings.

4. Referral signup form

What is it?

Referral signup form is a theme app block used for the Customer referral feature. It allows you to place a Customer referral signup form directly on a store page, so customers can join the referral program and get their referral link from that page.

What do you need to configure in UpPromote?

To make this block work correctly, you need to:

1. Go to Outreach > Affiliate recruitment > Customer referral > Set up

2. Turn on Customer referral

3. In the Displays section, enable the signup form / landing-page style display for Customer referral

How to show it on your theme

Referral signup form needs both conditions below:

1. The Customer referral feature must be active, and the signup form display must be enabled in UpPromote

2. The Referral signup form app block must be added to a page/template in Shopify Theme Editor

To add it to your theme:

1. In Shopiy admin, go to Online store > Themes

2. Click Customize on your live theme

3. Open the page or template where you want the form to appear

4. Click Add block on the left panel

5. Choose Referral signup form

6. Save the theme

Learn more

• View the Customer referral guide for feature setup and display settings

• Learn how to Add Referral signup form to store pages guide for a fuller storefront setup flow

5. Affiliate signup form

What is it?

Affiliate signup form is a theme app block that lets merchants show the affiliate registration form of the default program directly on a store page.

What do you need to configure in UpPromote?

For now, this block only supports the Default program on the merchant’s storefront theme. To make the block work:

1. Make sure the Default program is enabled in UpPromote

2. Configure the Default program settings as desired before adding the block to your store page

3. Contact UpPromote Support team via in-app live chat or email to [e-mail] so they can help you enable the app block option on your theme.

How to show it on your theme

Affiliate signup form needs both conditions below:

1. The Default program must be enabled in UpPromote

2. The Affiliate signup form app block must be added to a page/template in Shopify Theme Editor

Once the support team has enabled this app block for you, here's how to add it to your theme:

1. In Shopify Admin, go to Online Store > Themes

2. Click Customize on your live theme

3. Open the page or template where you want the form to appear

4. Click Add block

5. Choose Affiliate signup form

6. Save the theme

Learn more

View our full guide on how to create a landing page for Affiliate signup form and add the form to that newly created page. If you'd like to customize the form's look and content, see the guide here.