> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.transcy.io/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).
# 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](#2-i-check-theme-compatibility)
[II. Add the Transcy Switcher App Block](#2-ii-add-the-transcy-switcher-app-block)
[III. Theme Rename Method](#2-iii-theme-rename-method)
[IV. Manual Code Integration](#2-iv-manual-code-integration)
1. [Getting the Code](#3-1-getting-the-code)
2. [Embedding Code to Your Theme](#3-2-embedding-code-to-your-theme)
[V. Ask Support for a Custom Position](#2-v-ask-support-for-a-custom-position)
## I. Check Theme Compatibility
First, check if your theme is on our [supported themes list](https://help.transcy.io/en/article/faq-which-are-themes-supported-for-embedded-switcher-in-your-page-header-kja0dd/). If your theme isn't supported, you might see a message like this:
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 Store** → **Themes** → **Customize**. 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 admin** → **Online Store** → **Themes** → **Customize**
→ 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 **Transcy** → **Switcher settings** → **Advanced** → **Customization** → **Switcher** 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 admin** → **Online Store** → **Themes**
2. Click the **three dots** icon next to your theme
3. Select **Rename**
|| Good to know: Renaming your theme won't change how it works or looks - it's completely safe!
4. Add "**TC**" after your original theme name
5. Click **Save**
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:**
```html
```
**For mobile display:**
```html
```
### 2. Embedding Code to Your Theme
1. From **Shopify admin**, go to **Online Store** → **Edit Theme**
2. Click **Three dot** → **Edit 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**
**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](https://help.transcy.io/en/article/faq-how-to-create-a-request-support-ticket-with-transcy-q35ho9/) for priority assistance.
## Related Articles
* [Why is my embedded switcher back to floating format after changing theme?](https://help.transcy.io/en/article/faq-why-does-my-embedded-switcher-back-to-floating-format-after-changing-theme-1bdqy43/)
* [Which themes are supported for Embedded Switcher in your page header?](https://help.transcy.io/en/article/faq-which-are-themes-supported-for-embedded-switcher-in-your-page-header-kja0dd/)
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](mailto:support@transcy.io)