Basic EPiServer Language Switcher

A language switcher is a common task in any EPiServer implementation. In this blog I will show you how to implement a basic language switcher using the EPiServer API.


First, we will create a basic Header Helper class which will help us with the basic functionality

    public static class HeaderHelper
        public static Injected LanguageBranchRepository { get; }

        // Returns the list of available languages in the site
        public static List GetAvailableLanguages()
            return LanguageBranchRepository.Service.ListEnabled().ToList() ?? new List();

        // Return the current language
        public static LanguageBranch GetCurrentLanguage()
            var currentLanguage = GetAvailableLanguages().Find(x => x.LanguageID ==
            return currentLanguage;

        // Return the current page URL based on a specific selected language
        public static string GetCurrentUrlLocalized(PageData currentPage, LanguageBranch selectedLanguage)
            var contentLink = currentPage?.ContentLink;

            if (contentLink != null)
                return UrlResolver.Current.GetUrl(contentLink, selectedLanguage.LanguageID);

            return "/";

Using this helper class we can implement the language switcher easily in the view part

<select name="languages" onchange="location = this.value;">
    <option value="@HeaderHelper.GetCurrentUrlLocalized(Model.CurrentPage, currentLanguage)" selected>

    @foreach (var language in HeaderHelper.GetAvailableLanguages())
        if (language == currentLanguage)

        <option value="@HeaderHelper.GetCurrentUrlLocalized(Model.CurrentPage, language)">

The current language is not taken into account in the foreach loop, but it is set as the first selected option in the combo box. NativeName returns the language using its proper name. For instance, for Spanish, will display Español instead of Spanish. Finally, Model.CurrentPage is a PageData that represents the Start Page of the site.

And that is all. With a few lines of code you can create a functional language switcher. I hope it will help someone and as always keep learning !!!

Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Google photo

You are commenting using your Google account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s

Blog at

Up ↑

%d bloggers like this: