Embed Switcher to Unsupported Themes with Transcy

Want to embed Transcy's language and currency switcher to your store, but your theme doesn't support it natively? Don't worry! This guide shows you every way to get your switcher working on any Shopify theme, even if it's not on our supported list.


Embedding a language and currency switcher can greatly improve your customers' shopping experience. While most modern themes work perfectly with Transcy, some older or custom themes might need a little extra setup.


Table of Contents


I. Check Theme Compatibility


II. Add the Transcy Switcher App Block


III. Theme Rename Method


IV. Manual Code Integration

  1. Getting the Code
  2. Embedding Code to Your Theme


V. Ask Support for a Custom Position


I. Check Theme Compatibility


First, check if your theme is on our supported themes list. If your theme isn't supported, you might see a message like this:


Error message showing theme compatibility issue with Transcy switcher


No need to panic. Pick the method that matches your theme:


Your theme

Method to use

Online Store 2.0 — Dawn, Refresh and other current themes

App block. No code, and you choose exactly where the switcher sits

Vintage — Debut and other older Liquid themes

App blocks do not exist in these themes. Use the rename method, or add the code manually

Any theme, but you need the switcher somewhere the methods above can't reach

Ask our support team. We can set a custom position for your theme


Not sure which one you have? Open Online StoreThemesCustomize. If you can click Add block inside a section, your theme is Online Store 2.0.


II. Add the Transcy Switcher App Block


The quickest option on an Online Store 2.0 theme — it places the switcher without renaming anything and without touching theme code.


→ Go to Shopify adminOnline StoreThemesCustomize
→ Select the section where you want the switcher
→ Click Add block, open the Apps tab and choose Transcy Switcher
→ Drag the block to the position you want, then click Save


Your switcher Position must be set to Embedded in the page for the block to be used — find it in TranscySwitcher settingsAdvancedCustomizationSwitcher tab → Position.


Only one switcher shows per page. If several Transcy Switcher blocks are added to the same page, the one in the first position is displayed and the rest are ignored.


Where you can place the block


Placement

What to expect

Header

The switcher button is not cut off, and the dropdown opens over the page instead of being hidden behind it

Footer

The dropdown scrolls, so language, currency and country can all be selected normally

Any other section

The block can be dropped into any section that accepts blocks. Header and footer are the placements we test


III. Theme Rename Method


Use this on a Vintage theme, or whenever the app block is not available:


  1. Go to your Shopify adminOnline StoreThemes
  2. Click the three dots icon next to your theme
  3. Select Rename


Shopify theme options menu showing rename option


Good to know: Renaming your theme won't change how it works or looks - it's completely safe!


  1. Add "TC" after your original theme name
  2. Click Save


Theme rename dialog showing how to add TC suffix to theme name


That's it! Your Transcy switcher should now appear on your store.


IV. Manual Code Integration


If the rename method doesn't work, you can manually add the switcher code:


1. Getting the Code


Copy the appropriate code for your needs:


For desktop display:

<div class="transcy-switcher-manual transcy-desktop hidden"></div>


For mobile display:

<div class="transcy-switcher-manual transcy-mobile hidden"></div>


2. Embedding Code to Your Theme


  1. From Shopify admin, go to Online StoreEdit Theme
  2. Click Three dotEdit code
  3. Search for your header file (usually named header.liquid)
  4. Insert the code where you want the switcher to appear
  5. Click Save


Shopify theme code editor showing header file selection


Code editor interface showing where to insert Transcy switcher code


Pro tip: If you want the switcher in your header, embed the code in the header file. For other locations like footer or sidebar, find the corresponding template file.


V. Ask Support for a Custom Position


Some layouts need the switcher in a spot none of the methods above can reach. Our support team can configure a custom position for your theme.


Reach us through LiveChat in the app, or submit a support ticket for priority assistance.




Need help with your setup? Our support team is ready to assist you through LiveChat in your app or email us at support@transcy.io

Updated on: 17/08/2026

Was this article helpful?

Share your feedback

Cancel

Thank you!