> For the complete documentation index, see [llms.txt](https://docs-shpf.bsscommerce.com/b2b-wholesale-solution/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs-shpf.bsscommerce.com/b2b-wholesale-solution/b2b-pricing/more-add-depth-and-flexibility-to-your-b2b-pricing/extra-fee/settings-for-extra-fee.md).

# Settings for Extra Fee

Configure global behavior and display preferences for all Extra Fee rules.

These settings apply to **all** Extra Fee rules. They control how fees interact with free shipping and tax, and how the fee table looks on your storefront. Open them from **B2B pricing › Extra Fee**, then click **Settings** in the page header. Change an option and click **Save** in the save bar. The **Live preview** on the right updates as you change the design.

<figure><img src="https://1478990334-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGolQYRPH9iUGYatlTXwl%2Fuploads%2Fgit-blob-60765bc281260e016f229198826886cedf36a17f%2Fcms-ef-settings-01.png?alt=media" alt="Extra Fee settings"><figcaption><p>Extra Fee settings</p></figcaption></figure>

The Customization panel has four collapsible sections — click a section title to open it.

## Free shipping calculation

Controls what happens when only some of the Extra Fee rules in the cart offer free shipping (a range with **Free shipping** ticked).

| Setting                                                                          | Behavior                                                                                             |
| -------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- |
| **Free shipping for the whole order when one Extra Fee rule offers it** — ticked | If at least one Extra Fee rule applied to the cart offers free shipping, the whole order ships free. |
| Not ticked                                                                       | The order ships free only when every Extra Fee rule applied to the cart offers free shipping.        |

{% hint style="info" %}
Free shipping from Extra Fee takes priority over a Shipping Rate rule. A discount code that gives free shipping takes priority over both.
{% endhint %}

## Show Extra Fee table on pages

Choose where customers see the fee table (all three are ticked by default):

* **Product pages** — customers see the fee table while browsing a product.
* **Cart page** — the table appears in the cart before checkout.
* **Mini cart** — the table appears in the slide-out cart drawer.

The fee itself is always added as a line item at the checkout B2B Solution creates, whichever pages you tick here.

## Design

Match the fee table to your storefront branding. Pick a color for each element:

| Element                                       | Options                     |
| --------------------------------------------- | --------------------------- |
| **Header background** / **Header text**       | Color of the table header   |
| **Row background** / **Row text**             | Color of each row           |
| **Row hover background** / **Row hover text** | Color when a row is hovered |

## Auto-apply Tax

| Setting                                  | Behavior                                                                                                                                      |
| ---------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| **Automatically apply tax to Extra Fee** | When ticked, tax is calculated for all Extra Fee line items in your store. This applies to all Extra Fee rules. When off, fees are not taxed. |

***

## Translation

To translate the text customers see in the fee table, click **More actions › Translations** in the Extra Fee header. Choose a language and translate these items:

* **Quantity range validation** text
* **Amount range validation** text
* **Fee** text

The correct translation is shown according to the customer's storefront language. Click **Save** to store your translations.

<figure><img src="https://1478990334-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGolQYRPH9iUGYatlTXwl%2Fuploads%2Fgit-blob-a7e711b6d9dc69a057e8a729cbe93710d9b9a643%2Fcms-ef-settings-02.png?alt=media" alt="Extra Fee translations"><figcaption><p>Extra Fee translations</p></figcaption></figure>

***

## Storefront setup

Open **Storefront setup** in the Extra Fee header to check and install the fee table on your theme.

* The Extra Fee table is installed automatically when the module is on and the app embed is on in your theme. The page shows a checklist (module on, app embed on) with **Turn on module**, **Open theme editor** and **Check again** buttons.
* If your theme doesn't show the table, use **Manual installation** on the same page. It gives you copy-ready code for three places — the **product page**, the **cart page** and the **mini cart** — with the theme files to look in (for Dawn: `sections/main-product.liquid` and `sections/main-cart-items.liquid`).
* If your theme has other or custom pages, chat with us or email **<support@bss-b2b.solutions>** — our team sets it up on your theme for free.

{% hint style="warning" %}
If the part of the theme added by our app is changed, the fee table may stop working correctly.
{% endhint %}

<figure><img src="https://1478990334-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGolQYRPH9iUGYatlTXwl%2Fuploads%2Fgit-blob-42197babd8915e2726b3c555f30656eaa7351315%2Fcms-ef-settings-03.png?alt=media" alt="Extra Fee storefront setup"><figcaption><p>Extra Fee storefront setup</p></figcaption></figure>

***

#### 🧠 Pro Tips

* Use **descriptive names** for each fee rule to avoid confusion when managing multiple rules.
* Always **test** your fee logic with a test customer before relying on it.
* Combine Extra Fee with **B2B Pricing** modules to build a truly comprehensive B2B pricing structure.

### Troubleshooting

**My extra fee doesn't show.** Check that Extra Fee and the app embed are **On**, the rule is **Enabled**, and the customer, products and cart fall in one of its ranges. The fee table shows in the cart when it is ticked under **Show Extra Fee table on pages**, and the fee is added as a line at the checkout B2B Solution creates. Manual orders do not add extra fees.

**Why is the fee a separate item on the order with no SKU?** Each fee is added as a custom line item named after the rule, with quantity 1 and no SKU. It is not a Shopify product, so it has no inventory, and apps that sync or fulfill orders see it as its own line.

{% hint style="info" %}
If you need further assistance, please feel free to reach us at [**support@bss-b2b.solutions**](mailto:support@bss-b2b.solutions) or [**Live Chat**](https://go.crisp.chat/chat/embed/?website_id=9f64b5a9-1a02-4190-93b8-8ef56b19f740).
{% endhint %}
