Ready to get started?Download WordPress


Attention Interested in functions, hooks, classes, or methods? Check out the new WordPress Code Reference!

Function Reference/get locale


Gets the current locale.

If the locale is set, then it will filter the locale in the 'locale' filter hook and return the value.

If the locale is not set already, then the WPLANG constant is used if it is defined. Then it is filtered through the 'locale' filter hook and the value for the locale global set and the locale is returned.

The process to get the locale should only be done once but the locale will always be filtered using the 'locale' hook.


<?php get_locale() ?>



Return Values

The locale of the blog or from the 'locale' hook.


This sets the monetary locale and if empty, sets as en_US

setlocale(LC_MONETARY, get_locale());
$my_local_settings = localeconv();
if ($my_local_settings['int_curr_symbol'] == "") setlocale(LC_MONETARY, 'en_US');

This shows the value of setlocale:

setlocale(LC_MONETARY, get_locale());


  • Uses: apply_filters() Calls 'locale' hook on locale value.
  • Uses: $locale Gets the locale stored in the global.
  • Uses global: (unknown) $locale
  • l10n is an abbreviation for localization.

Change Log

Since: 1.5.0

Source File

get_locale() is located in wp-includes/l10n.php.


Localization: get_locale(), load_default_textdomain(), load_plugin_textdomain(), load_textdomain(), load_theme_textdomain()

See also index of Function Reference and index of Template Tags.