> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.hoppyapps.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 🎨 Upsell & Cross Sell – Design & Styling

The Design tab gives you full control over how your Upsell & Cross Sell widget looks and feels on your storefront. From background colors and spacing to typography and button styling — every visual part of the widget can be customized to match your brand.

Each upsell setup (Product page, Cart page, Cart Drawer, or Custom Position) has its **own independent Design settings**, so you can style a cart drawer widget differently from a product page widget ✨

Most color-related settings include:

* A visual **Color Picker**  
    
* A **Hex Code** input

This makes it easy whether you prefer picking colors visually or pasting your exact brand colors.

# **⚠️ Before You Begin**

To configure Design settings:

→ Open an existing Upsell & Cross Sell setup → Or create a new setup first

Then open the **Design** tab at the top of the setup page.

ℹ️ Design settings only change how the widget **looks**. What the widget says (titles, button text) is configured in the Content tab, and can be translated in Translation.

---

## **👀 Live Preview**

While you work inside the Design tab, a **live preview** is shown next to the settings. Every change you make is reflected in the preview immediately — no saving required to see how things look.

* **Desktop Preview** – Shows how the widget appears on desktop screens.  
* **Mobile Preview** – Shows the widget inside a mobile-sized frame, so you can verify readability on smaller devices.

💡 The preview uses your real upsell products, title, and button text, so what you see is very close to what customers will see on your storefront.

---

## **🖼️ Background**

* **What it does:** Controls the background appearance of the upsell widget section.  
* **Options Available:**  
  * **Single color** – Apply one solid background color.  
  * **Gradient** – Blend two colors together smoothly.

### **🎨 Single color**

* Choose a color using the **Color Picker** or manually enter a **Hex Code**.

### **🌈 Gradient**

* **Gradient angle degree:** Controls the direction of the gradient (0–360°).  
* **Initial & Final color pickers:** Select the two colors used in the gradient.

💡 A subtle gradient can help the upsell section stand out from the rest of the page without clashing with your theme.

---

## **📏 Spacing**

This section controls the spacing both inside and outside the upsell widget.

* **Inside top / bottom:** Adds internal spacing between the widget content and the edges of the section.  
* **Outside top / bottom:** Adds spacing outside the section to separate it from surrounding page elements.

All values are set in **pixels (px)**.

💡 Use **Outside** spacing to create breathing room between the widget and elements like the Add to Cart button, and **Inside** spacing to keep content from touching the section edges.

---

## **🔤 Typography**

This section controls how all the text elements appear inside the upsell widget.

### **🏷️ Upsell Title**

* **Upsell Title size:** Controls the size of the upsell section heading (e.g. *“Frequently bought together”*).  
* **Upsell Title color:** Changes the color of the section heading.

ℹ️ The upsell title text itself is edited in the **Content** tab, not here.

### **📦 Product Title**

* **Product Title size:** Controls the size of each product name inside the widget.  
* **Product Title color:** Changes the product title color.

### **💰 Price**

* **Price size:** Controls the product price text size.  
* **Price color:** Changes the product price color.

### **➡️ Arrow**

* **Arrow size:** Controls the size of the slider navigation arrows.  
* **Arrow color:** Changes the arrow color.

ℹ️ Navigation arrows only appear when the widget contains **more than one product** to slide through.

---

## **🔘 Button**

This section customizes the upsell call-to-action button (e.g. *“Add to Cart”*) shown for each product.

### **🎨 Button Color**

* Changes the background color of the button. The button border automatically uses the same color.

### **🔤 Button Text Size & Color**

* Controls the size and color of the text inside the button.

### **⭕ Corner Radius & Button Style**

* **Corner radius:** Sets how rounded the button corners appear, in pixels.  
* **Button style:** Quickly switch between *Square*, *Rounded*, and *Fully rounded*.

ℹ️ These two settings stay in sync automatically:

* Choosing a **Button style** applies a matching corner radius.  
* Typing a **Corner radius** value updates the style — low values become *Square*, mid values become *Rounded*, and high values become *Fully rounded*.

### **💪 Font Weight**

* Controls how bold or light the button text appears.  
* Select **Inherit** to follow your theme’s existing font weight, or choose a specific weight from **100** (thinnest) to **900** (boldest).

### **✍️ Font Style**

* Toggle between:  
  * *Normal*  
  * *Italic*  
  * *Underline*

---

## **💾 Saving & Publishing Your Design**

Design changes are not live until they are saved.

1. Make your changes in the **Design** tab — the live preview updates instantly.  
2. Click **Save** in the save bar at the top of the page.  
3. Make sure the upsell is **Published** so the updated design appears on your storefront.

⚠️ **Please note:** Color values entered as hex codes are validated on save. If a hex code is invalid (for example, missing the `#` or containing invalid characters), saving will be blocked and an error message will highlight the field that needs fixing.

ℹ️ If your design is saved and published but the widget itself isn’t visible on the storefront, the cause is usually related to app embeds, placement, or targeting — see Upsell & Cross Sell is Not Showing on My Store \[Fixed\].

---

## **🛍️ How Design Changes Reflect on the Storefront**

When you save a published setup, the app updates your store automatically. The storefront widget reads your Design settings and applies them everywhere the widget renders:

* **Background** → Fills the widget section with your single color or gradient.  
* **Spacing** → Applies your inside padding and outside margins around the widget.  
* **Typography** → Styles the upsell title, product titles, prices, and navigation arrows.  
* **Button** → Styles each product’s Add to Cart button, including corner radius, font weight, and font style.

Because every setup type (Product page, Cart page, Cart Drawer, Custom Position) stores its own design, changing one setup never affects the appearance of the others.

---

## **🚀 Final Result**

Once configured successfully, the **Design & Styling** settings help merchants create a more visually engaging, professional, and conversion-focused shopping experience.

With proper styling customization in place:

✅ The upsell widget feels aligned with your store branding   
✅ Product recommendations become more noticeable and engaging   
✅ Prices and product titles stay readable on both desktop and mobile   
✅ CTA buttons become more visually attractive   
✅ Each placement can carry its own look and feel   
✅ Customers experience a more polished and trustworthy interface

Using these design and styling options effectively can greatly improve customer engagement, storefront presentation, and overall conversion potential ✨