# App extensions

## 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 

#### 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](https://docs.uppromote.com/settings/advance-settings/message-bar?utm_source=docs\&utm_medium=message-bar\&utm_campaign=app-extensions) 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](https://docs.uppromote.com/outreach/affiliate-recruitment/customer-referral?utm_source=docs\&utm_medium=cr-widget\&utm_campaign=app-extensions#id-1.-widget) 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](https://docs.uppromote.com/outreach/affiliate-recruitment/customer-referral?utm_source=docs\&utm_medium=cr-block\&utm_campaign=app-extensions) guide for feature setup and display settings
* Learn how to [Add Referral signup form to store pages](https://docs.uppromote.com/outreach/affiliate-recruitment/customer-referral/add-referral-signup-form-to-store-pages?utm_source=docs\&utm_medium=cr-block\&utm_campaign=app-extensions) 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 <support@secomapp.com> so they can help you enable the app block option on your theme.&#x20;

#### 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](https://docs.uppromote.com/management/affiliate-registration-form/add-registration-form-to-storefront?utm_source=docs\&utm_medium=aff-block\&utm_campaign=app-extensions) 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](https://docs.uppromote.com/management/affiliate-registration-form/form-editor?utm_source=docs\&utm_medium=aff-block\&utm_campaign=app-extensions).&#x20;