We have moved!

You are currently looking at documentation for Umbraco 8 and older versions.
Go to docs.umbraco.com for documentation for Umbraco 9 and newer versions.


    The LocalizationService acts as a "gateway" to Umbraco data for operations which are related to Dictionary items and Languages.

    Browse the API documentation for ILocalizationService.

    • Namespace: Umbraco.Core.Services
    • Assembly: Umbraco.Core.dll

    All samples in this document will require references to the following dll:

    • Umbraco.Core.dll

    All samples in this document will require the following using statements:

    using Umbraco.Core;
    using Umbraco.Core.Models;
    using Umbraco.Core.Services;

    Getting the service

    Services property

    If you wish to use use the localization service in a class that inherits from one of the Umbraco base classes (eg. SurfaceController, UmbracoApiController or UmbracoAuthorizedApiController), you can access the localization service through a local Services property:

    ILocalizationService localizationService = Services.LocalizationService;

    Dependency Injection

    In other cases, you may be able to use Dependency Injection. For instance if you have registered your own class in Umbraco's dependency injection, you can specify the ILocalizationService interface in your constructor:

    public class MyClass
        private ILocalizationService _localizationService;
        public MyClass(ILocalizationService localizationService)
            _localizationService = localizationService;

    Static accessor

    If neither a Services property or Dependency Injection is available, you can also reference the static Current class directly:

    ILocalizationService localizationService = Umbraco.Core.Composing.Current.Services.LocalizationService;


    • Retrieving languages
      See examples on how to retrieve languages via the localization service - either individually or as a collection.