Pricebooks allow you to define and manage product pricing across regions, customer segments, and currencies. This guide explains how to create, edit, and assign Pricebooks.
Available as a paid add-on with any of the following subscriptions: Lite, Growth, Scale.
What is a Pricebook?
A Pricebook is a list of products with specific prices or currencies. It enables you to tailor pricing without changing your global product settings.
-
A single Pricebook can include prices in multiple currencies.
-
If you need different prices in the same currency (e.g., EUR pricing for both Germany and Finland, but with different amounts), you must create separate Pricebooks for each.
Creating a Pricebook
To create and manage Pricebooks:
-
Go to the Product in your HeadQ dashboard.
-
Open the Pricebooks
-
Click Create New Pricebook.
-
Add a name and (optionally) a description.
-
Save the Pricebook.
You can edit default prices for each product directly within the Pricebook view.
Editing Option / Variation
To edit option / Variation-level pricing (e.g., for product variants or configurations):
-
Go to the Product.
-
Click the three-dot menu
-
Select Pricing to adjust option / variation-specific pricing per Pricebook and currency.
Controlling Which Pricebook Is Used per Country
Pricebooks are automatically selected based on the visitor's country. This behavior is defined via the embed script on your storefront. Read more about how to install the HeadQ Script.
Default Script
<script type="text/javascript">
(function(h,e,a,d,q) {
h.__HQ__ = { store: 'test' };
d = e.getElementsByTagName('head')[0];
a = e.createElement('script');
a.type = 'text/javascript';
a.src = 'https://cdn.myheadq.com/static/headq.js';
d.appendChild(a);
q = e.createElement('link');
q.rel = 'stylesheet';
q.href = 'https://cdn.myheadq.com/static/headq.css';
q.type = 'text/css';
d.appendChild(q);
})(window,document);
</script>
Setting the Country Programmatically
To explicitly define which country (and thereby which Pricebook and currency) should be used for the visitor, update the customerLocation in the script:
<script type="text/javascript">
(function(h,e,a,d,q) {
h.__HQ__ = {
store: 'test',
customerLocation: { country_code: 'DE' } // Germany
};
d = e.getElementsByTagName('head')[0];
a = e.createElement('script');
a.type = 'text/javascript';
a.src = 'https://cdn.myheadq.com/static/headq.js';
d.appendChild(a);
q = e.createElement('link');
q.rel = 'stylesheet';
q.href = 'https://cdn.myheadq.com/static/headq.css';
q.type = 'text/css';
d.appendChild(q);
})(window,document);
</script>
Replace 'DE' with the desired two-letter ISO country code (in uppercase). The selected country determines:
-
The currency used
-
The Pricebook applied
-
Any regional configurations from Settings → Region
Assigning Currency and Pricebook to a Country
To define which Pricebook and currency each country should use:
-
Go to Settings → Region in your HeadQ admin.
-
Select the country you want to configure.
-
Assign the default currency and Pricebook for that country.
Combined with the country code in your embed script, these settings ensure customers automatically see the correct pricing based on their region.
Best Practices
-
Use one Pricebook per region/currency combination where pricing differs.
-
Name clearly (e.g., "EUR - Germany", "USD - US") to make selection easier.
-
Test country logic by changing the
country_codein your embed script. -
Keep Pricebooks up to date to reflect any pricing or currency changes.