📖 Help Center

T-Selector Help Center

Step-by-step guides for every feature. Set up VAT rates, translations, VAT exemption, and more.

🚀

Getting Started

Start here

After installing T-Selector, we handle the technical setup for you. Here's what to expect at every step.

⏱ 1–2 business days
1

Complete the setup questionnaire

Right after installation, you'll see a short questionnaire (~60 seconds). It asks 6 quick questions about your store:

• Do your Shopify prices include VAT or not?
• What should the default pricing view be?
• Would you like a popup for customers to choose B2B/B2C pricing?
• Do you want helper text next to prices (e.g. "incl. VAT")?
• What should the floating widget do? (price toggle, VAT exemption, both, or none)
• Your email address + optional message about your needs

You'll also see an info screen about our VAT Exemption feature for B2B customers — this explains how it works so you can enable it later from your dashboard.

💡Don't worry if you're unsure — you can go back and change answers, and we can adjust all settings later too.
2

Enter your email and any special notes

At the end of the questionnaire, enter your email so we can contact you when setup is complete. There's also an optional message box where you can tell us anything specific about your store — for example, special apps you use, B2B requirements, or timeline needs. Click Submit.

3

Accept our collaboration request

We'll send a Shopify collaborator request to your store. Please accept the request — this gives us temporary access to set up T-Selector on a duplicate of your theme.

⚠️Check your Shopify notifications and email. If you don't see the request within 24 hours, email us at hello@zoeproduction.com.
4

We configure everything on a duplicate theme

We create a copy of your live theme and set up T-Selector on it. Your live store is never affected. Based on your questionnaire answers, we will:

• Add the B2B/B2C price toggle to your header
• Identify all price elements across your pages
• Configure the CSS selectors so every price updates correctly
• Set up the floating widget based on your choice (toggle, exemption, or both)
• Add the VAT Exemption form to your cart page if applicable
• Apply your other preferences (popup, helper text, etc.)

✅Your live store runs normally during setup. We only work on the duplicate theme.
5

You receive an email when ready

Once setup is complete, we email you with instructions to preview the duplicate theme. Test the toggle, check different pages, and verify everything looks right.

6

Go live

When you're happy, simply publish the duplicate theme from Shopify Admin → Online Store → Themes. That's it — your customers can now switch between VAT-inclusive and VAT-exclusive pricing.

💡If anything doesn't look right, reply to our email and we'll adjust it for free.
💰

VAT Rates

VAT rates tell T-Selector how much tax to deduct or add for each country. Once configured, prices update automatically based on visitor location.

⏱ ~2 minutes
1

Open the VAT-Rates tab

In your T-Selector dashboard, click VAT-Rates in the top navigation.

2

Import your active markets (recommended)

Click the Import Active Markets button. This automatically imports all countries from your Shopify Markets configuration with the correct VAT rate for each country.

✅This is the fastest way to set up VAT rates. The correct percentages are applied automatically based on current tax regulations.
3

Or add countries manually

Click + Add VAT Rate to add individual countries. Select the country from the dropdown, enter the correct "Store wide VAT/Tax" percentage, and click Submit.

4

Review and edit rates

Your VAT rates table shows each country with its tax percentage. Click Edit to adjust any rate or Delete to remove a country.

Common EU rates: Sweden 25%, Germany 19%, France 20%, UK 20%, Belgium 21%, Austria 20%, Switzerland 8.1%.

⚠️Make sure rates match your Shopify tax settings. If your store prices include VAT, the rate here should match the VAT percentage in the country.
5

Product tag-based VAT (optional)

If you sell products with different VAT rates (e.g. food at 12%, standard goods at 25%), you can configure tag-based VAT. When editing a country, click the + button next to "Product tag base VAT rate" to add product-specific rates.

💡Need help with tag-based VAT? Contact us at hello@zoeproduction.com and we'll configure it for you.
🌍

Translate

Translate all T-Selector labels so customers see text in their own language — popup, toggle, helper text, and VAT exemption form.

⏱ ~5 min per language
1

Open the Translate tab

Click Translate in the navigation. You'll see a list of all configured languages.

2

Import active languages or add manually

Click Import Active Languages to pull in languages from your Shopify configuration, or + Add Translation to add one manually.

3

Fill in the translation fields

Each translation has these fields for the popup and toggle:

Popup Title
Heading shown in the popup (e.g. "Welcome to Our Store")
Popup Sub-Title
Description text below the title
B2B Button Text
Label for business pricing (e.g. "Business", "Företag")
B2B Helper Text
Text shown next to B2B prices (e.g. "exc. VAT", "exkl. moms")
B2C Button Text
Label for consumer pricing (e.g. "Private", "Privat")
B2C Helper Text
Text shown next to B2C prices (e.g. "inc. VAT", "inkl. moms")
4

Translate VAT exemption fields (if enabled)

If you use VAT Exempt, there's an additional section with these fields:

VAT Exemption Title
Heading for the exemption form
VAT Exemption Description
Instructions for customers
Email Label / Warning
"Email" label and "Use this same email at checkout" warning
Country / VAT Number
Labels and placeholders for the form fields
Validation Messages
"Validating...", "Validated", "Invalid format", "Service unavailable", etc.
5

Save and repeat

Click Submit to save. Add translations for each language your store supports. T-Selector automatically shows the correct language based on the customer's browser or Shopify locale.

🎨

Design & Display

All design settings are configured through the Shopify Theme Editor. Clicking "Design" in the T-Selector dashboard opens the Theme Editor directly.

1

Open the Theme Editor

Click Design in the T-Selector navigation. This opens the Shopify Theme Editor with T-Selector's app embeds. You can also access it via Shopify Admin → Online Store → Themes → Customize → App embeds, then search for "T-Selector".

2

The three app embeds

T-Selector has three separate app embeds you can enable/disable independently:

VAT Toggle
The main widget — header toggle, floating switcher, and/or exemption button. This is the core of T-Selector.
VAT Switcher GMC Head
Adds structured data for Google Merchant Center. Simple on/off, no customization options.
VAT Choice Pop-Up
The popup that appears for visitors, letting them choose Business or Private pricing.
3

VAT Toggle — Widget Mode

Click on "VAT Toggle" to expand its settings. The Widget Mode dropdown controls what the toggle does:

Switcher Only — Customers switch between B2B (excl. VAT) and B2C (incl. VAT) pricing
Exemption Only — Only shows the VAT exemption button (for validating VAT numbers)
Both — Combines the switcher and exemption features

4

VAT Toggle — Widget Configuration

Configure the visual appearance of the toggle:

Enable Floating Switcher
Shows a floating toggle button on the page
Margins / Padding
Position and spacing of the widget
Background / Border
Colors and border styling
Label & Customization
Label sizes, colors for desktop and mobile, toggle switch scale
Helper Text Size/Color
Styling for the "(incl. VAT)" / "(excl. VAT)" text next to prices
CSS Selectors to Hide Helper
Hide helper text in specific areas (e.g. "span.compare-at-price")
5

VAT Toggle — Advanced Settings

Scroll to the bottom of the VAT Toggle settings for advanced options:

Price Selector
CSS selectors for finding price elements (e.g. "span.price, span.compare-at-price, text-comp…"). These are set during initial setup.
Show currency codes
Display currency code alongside prices
Modal Design
Customize the VAT exemption modal (width, colors, button styling)
Exemption Button
Icon, label, size, and colors for the floating VAT exempt button
Express Checkout Warning
Toggle the Apple Pay / Shop Pay bypass warning
⚠️Don't change the Price Selector unless you know what you're doing. If prices stop updating on some pages, contact us and we'll fix the selectors.
6

VAT Choice Pop-Up settings

Click "VAT Choice Pop-Up" in the app embeds to configure the popup:

Enable Popup
Turn the popup on or off
Show VAT Switcher in Popup
Include the B2B/B2C choice buttons (requires VAT Toggle to be enabled)
Enable VAT Exemption Fields
Add the VAT number validation form directly inside the popup
Popup Styling
Width, corner radius, background, overlay color
Typography
Font sizes and colors for headings, subheadings, and helper text
Buttons
Size, colors, border, and hover effects for the B2B/B2C buttons
💡Use "Enable Live Preview Mode" to preview the popup directly in the Theme Editor while adjusting settings.
⚙️

Settings

The Settings page controls global behavior — toggle style, default pricing, currency format, and cookie preferences.

1

Show Helper Text

When enabled, prices display with labels like "€100.00 (incl. VAT)" or "€80.00 (excl. VAT)". When disabled, prices show without any label. We recommend keeping this on for clarity.

2

Toggle style

Choose between two display styles:

Option Button — Two separate clickable buttons
Option Toggle — A single slide switch

3

Label style

Choose what the toggle labels say:

Ex. VAT / Inc. VAT — Tax-focused labels
Business / Individual — Customer-type labels
Both — Shows "Business exc. VAT" / "Private inc. VAT"

4

Toggle colors

Customize the switch appearance: On/Off background color, circle (knob) color, and border color. Match these to your store's branding.

5

Default pricing and tax settings

B2B Pricing / B2C Pricing — Which pricing view customers see by default before making a choice.

Product prices includes taxes — Enable this if your Shopify product prices are entered with VAT included. This tells T-Selector how to calculate the excl. VAT price.

🔴This setting is critical. If it doesn't match your actual Shopify tax configuration, prices will calculate incorrectly.
6

Cookie Validity

Controls how long a customer's B2B/B2C choice is remembered. Set to 0 days to show the popup on every visit, or increase it so returning customers don't need to choose again.

7

Currency format

The settings page shows a reference of Shopify currency formats. Choose the format that matches your store's currency setting in Shopify Admin → Settings → Store details. Common options:

→ 150,000.00
→ 150,000
→ 150 000,00
→ 150.000,00

8

Parenthesis style

Choose which type of parentheses to use around helper text — standard round brackets or custom options. Click Submit to save all settings.

🏢

VAT Exempt (B2B)

New

How VAT Exempt works

VAT Exempt lets your B2B customers validate their EU VAT number and shop without VAT. T-Selector verifies VAT numbers in real-time through the official EU VIES database, tags the customer as tax-exempt in Shopify, and removes VAT at checkout automatically.

🏢 Customer enters email + VAT number
→
🔍 VIES validates live
→
✅ Customer tagged tax-exempt
→
🧾 VAT removed at checkout
A

Enable VAT Exempt

▾
1

Go to the VAT Exempt tab

Click VAT Exempt in the navigation. The page shows whether VAT Exemption is Active or Inactive.

2

Enable or disable

Click the Enable VAT Exemption button to activate, or Disable VAT Exemption to turn it off. The status indicator shows green "Active" or grey "Inactive".

3

Configure VAT Validation Rules

Choose which EU countries can use VAT exemption. You can select all 28 EU member states or restrict to specific countries using the checkbox list. Use Select All or Deselect All for quick changes.

💡T-Selector automatically validates VAT IDs against VIES and tags verified customers as B2B in Shopify.
B

Where to show the VAT exemption form

▾

You have three options for where customers can enter their VAT number. You can use one or combine multiple:

1

Floating Widget

A small "VAT" button that floats on the page (typically bottom-right). Clicking it opens the VAT exemption form as a modal. Configure under Widget & Form Placement: enable/disable, choose desktop position, and enable/disable on mobile.

2

Inside the Pop-Up

Add the VAT exemption form directly inside the B2B/B2C choice popup. Go to Theme Editor → VAT Choice Pop-Up → enable "Enable VAT Exemption Fields". Customers see both the pricing toggle and VAT form in one place.

3

App Block (e.g. Cart Page)

Add a "VAT Exemption Form" app block anywhere in your theme that supports app blocks. The most common placement is on the Cart page, below the cart summary. Go to Theme Editor → select a page template → Add block → choose "VAT Exemption Form" from T-Selector.

The app block has its own settings: Show Express Checkout Warning, Show VAT field, Container Design (background, border, padding, radius), and Button Design.

💡The VAT Exempt settings page has quick links — "Add VAT Exemption Section to Cart Page" and "Enable the T-Selector VAT Exemption App Embed" — that open the Theme Editor directly to the right place.
C

What your customers experience

▾
1

Customer opens the VAT exempt form

Via the floating "VAT" button, the popup, or the app block on the cart page — the customer sees a form asking for their email address, country, and VAT number.

2

Customer enters their details and clicks "Validate VAT"

They enter their business email (which they must also use at checkout), select their country, and type their EU VAT number (e.g. DE123456789, SE556677889901).

🔴Critical: The customer must use the same email address when validating their VAT number AND at checkout. Otherwise the tax exemption won't be applied. The form shows a warning: "Use this same email at checkout".
3

Real-time VIES validation

T-Selector checks the VAT number against the EU VIES database in real-time. The customer sees status messages: "Validating..." → "Checking VAT database..." → "Validated" (or "Invalid format for selected country").

4

If valid — prices update and customer is tagged

On successful validation:

• A customer record is created in Shopify with taxExempt: true
• VAT data is stored in customer metafields (VAT number, validation status, company name)
• All prices on the store switch to excl. VAT
• The form shows "VAT exemption active for [company name]"

5

At checkout — VAT is removed automatically

Because the customer is tagged as tax-exempt in Shopify, the VAT is removed during checkout. Order note attributes also store the VAT number, country, and company name for your records.

⚠️Express checkouts (Apple Pay / Shop Pay) may bypass VAT exemption. The form warns customers about this. For guaranteed exemption, customers should use the standard checkout flow.
D

VIES Status Monitor & Reports

▾
1

EU VIES Status Monitor

At the bottom of the VAT Exempt page, you'll see a live status grid showing all EU member states. Each country shows "Available" (green) or "Unavailable" (red). The monitor auto-refreshes every 5 minutes.

💡Each EU member state maintains its own VIES database. Occasional downtime is normal — if a specific country shows unavailable, the customer can try again later.
2

VAT Exemption Reports

Click Download Report (CSV) to generate a CSV file of all verified VAT-free orders. This report is useful for accounting, tax filing, and OSS (One Stop Shop) reporting.

E

Common questions about VAT Exempt

▾
Q

Is VAT ID entry mandatory for customers?

▾
No, VAT ID entry is optional. Customers can always proceed to checkout without validating a VAT number. There is currently no setting to make it mandatory.
Q

Does it work for non-EU countries (UK, Norway, Switzerland)?

▾
VIES validation is specifically for EU VAT numbers. For non-EU B2B customers, contact us about custom solutions.
Q

What if the customer is in the same country as my store?

▾
You control which countries are allowed through the country selection checkboxes. Reverse charge typically only applies to cross-border EU transactions. If you're a Swedish store, you can exclude Sweden from the eligible countries so domestic B2B customers still pay VAT as required.
Q

What if VIES is temporarily down?

▾
Customers will see a "Service unavailable" message and can try again later. T-Selector never grants exemptions without successful VIES verification — this protects your business from fraud.
Q

Where is the VAT data stored?

▾
VAT data is stored in two places: Customer metafields (vat_number, vat_valid, vat_checked_at, vat_company_name under the "tax" namespace) and order note attributes (VAT Number, VAT Country, VAT Company). You can access these in your Order Printer templates or invoicing app.
Q

Does it work in cart drawers?

▾
The VAT exempt widget works on the cart page and through the floating widget/popup. Cart drawer compatibility depends on your specific theme implementation. If you need drawer support, contact us and we'll check your theme.
Q

What are the rules for EU reverse charge / VAT exemption?

▾
For intra-EU business transactions, VAT exemption (reverse charge) applies when all of these conditions are met:

• The buyer has a valid EU VAT ID
• The buyer is located in a different EU country than your store
• The goods are shipped to a country different from the merchant's country
• The merchant can verify these conditions (shipping receipt, validated VAT ID)

It is the merchant's responsibility to check the buyer's VAT ID validity and ensure goods are exported. T-Selector handles the VAT ID validation automatically through VIES — you handle the shipping.
Q

Why does the email field always show, even for logged-in customers?

▾
Currently, the email field is always visible. T-Selector needs the email address to match the customer with their VAT exemption status at checkout. Even if the customer is logged in, we display the field to ensure they use the correct email for the transaction.
Q

Can the VAT form be added directly inside the Shopify Checkout?

▾
Checkout integration for Shopify Plus stores is currently under development. For now, VAT validation takes place before checkout — via the popup, floating widget, or cart page app block. We'll notify existing customers when checkout integration becomes available.
Q

How can I use VAT data in invoices and order notifications?

▾
Validated VAT data is stored as order note attributes and customer metafields in Shopify. You can include this data in Order Printer templates, invoice apps, and Shopify email notifications using Liquid code. Contact us at hello@zoeproduction.com for the exact Liquid snippets for your invoice setup.
Q

Is T-Selector GDPR compliant?

▾
Yes. T-Selector does not store customer data on external servers. All VAT data (VAT numbers, company names, validation timestamps) is stored directly in your Shopify store as customer metafields and order attributes. If you delete customer data from Shopify (e.g. on a customer's GDPR request), it is automatically no longer available to T-Selector.
🔧

Troubleshooting

Common issues and how to resolve them. If your problem isn't listed here, email us at hello@zoeproduction.com with a link to the affected page.

!

VAT ID was validated but tax wasn't removed at checkout

▾
This is the most common support question. Check these items in order:

1. Did the customer use the same email?
The email entered in the VAT exemption form must match exactly the email used at checkout. If they differ, Shopify cannot match the customer to their tax-exempt status.

2. Are your Shopify tax settings correct?
Go to Shopify Admin → Settings → Markets → Preferences → Tax inclusion. Make sure the tax inclusion setting matches your actual pricing. If your store is misconfigured, Shopify may show removed tax lines but the total won't change.

3. Do you use market-specific fixed prices?
If you've set fixed prices per market (instead of dynamic pricing), Shopify won't change the product price when tax is removed — only the stated tax amount in checkout changes. Solution: Switch to dynamic pricing in Shopify Admin → Settings → Markets → [Market] → Duties and import taxes → select "Dynamic taxes".

4. Is the shipping address in a different country than your store?
EU reverse charge only applies to cross-border transactions. If the customer's shipping address is in the same country as your store, VAT exemption typically should not apply.

5. Did the customer proceed to checkout too quickly?
T-Selector communicates with Shopify's server to update the customer's tax status. If the customer clicks checkout immediately after validation, Shopify may not have processed the change yet. Solution: Go back to cart and proceed to checkout again.
⚠️If none of these apply, email us with the order number and customer email. We'll investigate.
!

An order was placed without tax, but no VAT ID was entered

▾
This happens when the customer's email address is already associated with a tax-exempt customer profile in Shopify. Here's why:

When a VAT ID is successfully validated, T-Selector sets the customer as taxExempt: true in Shopify. Shopify creates a customer profile for that email address. If the same email is used for a future order — even without entering a VAT ID — Shopify still considers them tax-exempt.

Solution: Go to Shopify Admin → Customers → find the customer profile → Contact → Edit → remove the tax-exemption checkbox. This will ensure they're charged tax on future orders unless they validate again.
!

There's a brief flash before prices update

▾
This is expected behavior. T-Selector is a frontend solution that recalculates prices after the page loads — similar to how currency converters work. The page needs to load with the original prices first, then T-Selector updates them. The delay is typically under one second and is barely noticeable on most connections.
!

Prices look wrong or keep flickering after installation

▾
This usually happens when a currency converter app or theme-built-in currency converter is running at the same time. Both T-Selector and the converter try to update prices in the frontend, which can create conflicts or endless update loops.

If your theme has a built-in currency converter: Contact us — this is usually easy to fix with a small configuration change.

If you use a third-party currency converter app: Contact both us and the converter app developer. We can usually find a compatible configuration.
💡Shopify Markets with multi-currency support works differently from frontend converters and is generally compatible with T-Selector.
!

Prices with superscript decimals aren't updating

▾
Some themes display decimals in a smaller, raised font (superscript). This makes it difficult for T-Selector to identify the full price as one element.

Solution: Check if your theme has an option to disable superscripted decimals in Theme Settings. If not, contact us and we'll adjust the CSS selectors to handle your theme's price format.
!

Customer used Apple Pay / Shop Pay and was charged VAT despite exemption

▾
Express checkout methods (Apple Pay, Google Pay, Shop Pay) can bypass the standard Shopify checkout flow where VAT exemption is applied. This is a Shopify platform limitation, not a T-Selector bug.

T-Selector shows a warning to customers: "Express checkouts (Apple Pay / Shop Pay) may bypass VAT exemption."

Solutions:
• Keep the express checkout warning enabled (it's on by default in the app embed settings)
• If VAT exemption is critical for your business, consider disabling express checkout buttons in your theme settings for the cart/product pages
• Advise B2B customers to use the standard checkout flow
!

How to verify VAT exemption is working correctly

▾
Follow this checklist to test the full flow:

1. Submit a test order using a VAT ID (use a valid EU VAT number from a country different from your store's)

2. Check the customer profile (Shopify Admin → Customers):
• Is the customer marked as tax-exempt? ✓
• Does the customer have metafields with VAT data (vat_number, vat_valid)? ✓

3. Check the order (Shopify Admin → Orders):
• Does the order contain note attributes with the VAT Number, VAT Country, and VAT Company? ✓
• Are tax lines absent from the order summary? ✓

4. Check the CSV report (T-Selector → VAT Exempt → Download Report):
• Does the test order appear in the report? ✓

If all checks pass, VAT exemption is working correctly.
✅Remember to manually remove the tax-exemption from the test customer profile after testing, so they aren't permanently exempt.
!

VAT is being added/removed from gift cards

▾
T-Selector's price toggle applies to all price elements on the page — including gift cards. This is expected behavior since the VAT adjustment is visual and applies store-wide. The actual gift card value and tax handling at checkout follows your Shopify tax rules for gift cards.
❓

Frequently Asked Questions

Q

Prices aren't updating on some pages

▾
This usually means the CSS selectors need updating. It can happen after theme updates, installing new apps, or changing page layouts. Contact us at hello@zoeproduction.com with a link to the affected page and we'll fix it.
Q

I changed my theme — do I need to reconfigure?

▾
Yes. Different themes have different HTML structure, so the price selectors need to be updated. Send us a collaboration request and we'll set up T-Selector on your new theme at no extra cost.
Q

Does T-Selector work with subscription and bundle apps?

▾
Yes, T-Selector works with most subscription and bundle apps. Some may require custom CSS selector configuration to capture their specific price elements. Contact us with the name of your app and we'll ensure compatibility.
Q

Will T-Selector slow down my store?

▾
T-Selector is designed to be lightweight. The script loads asynchronously and doesn't block page rendering. Price calculations happen on the client side for instant updates.
Q

What does "ADD-ON SERVICES" do?

▾
The ADD-ON SERVICES button links to our premium services — custom setup, theme migration, advanced configuration, and more. These are optional paid services for merchants who need extra help.
Q

What plans are available?

▾
T-Selector offers a Monthly Plan at $49/month and a Yearly Plan at $348/year ($29/month). Both include unlimited VAT rates and languages. All plans come with a 7-day free trial — if you uninstall before 7 days, you won't be charged. Manage your plan in the Plans tab.
Q

How do I cancel or change my plan?

▾
You can manage your subscription through the Plans tab in T-Selector, or via Shopify Admin → Settings → Apq">
Q

Does T-Selector work with products that have different VAT rates?

▾
Yes — T-Selector supports product tag-based VAT rates. For example, if you sell food items at 12% VAT and standard goods at 25%, you can configure different rates using product tags. Contact us at hello@zoeproduction.com to set this up.
Q

Is T-Selector GDPR compliant?

▾
Yes. T-Selector does not store customer data on external servers. All data (VAT numbers, validation results, company information) is stored directly within your Shopify store as customer metafields and order attributes. If you delete customer data from Shopify, it is no longer available to T-Selector. We only access customer data when using VAT ID validation and reporting features.

Still need help?

We typically respond within a few hours on business days.

✉️ hello@zoeproduction.com