diff --git a/addons/actions.md b/addons/actions.md
index a3b336fd92..a1c4f93128 100644
--- a/addons/actions.md
+++ b/addons/actions.md
@@ -297,6 +297,25 @@ You can place these XML files anywhere on your file system that openHAB has perm
 In the calls to the Actions, use the fully qualified path.
 We recommend placing these custom files somewhere inside your `$OH_CONF` folder, such as `$OH_CONF/services`.
 
+#### Localisation
+
+Ephemeris supports translation of holidays into many languages. Localization support files can be found in the [GitHub repo](https://github.com/svendiedrichsen/jollyday/tree/master/src/main/resources/descriptions). Currently these language supports are available:
+
+1. [Dutch](https://github.com/svendiedrichsen/jollyday/blob/master/src/main/resources/descriptions/holiday_descriptions_nl.properties)
+1. [English](https://github.com/svendiedrichsen/jollyday/blob/master/src/main/resources/descriptions/holiday_descriptions_en.properties)
+1. [French](https://github.com/svendiedrichsen/jollyday/blob/master/src/main/resources/descriptions/holiday_descriptions_fr.properties)
+1. [German](https://github.com/svendiedrichsen/jollyday/blob/master/src/main/resources/descriptions/holiday_descriptions_de.properties)
+1. [Portuguese](https://github.com/svendiedrichsen/jollyday/blob/master/src/main/resources/descriptions/holiday_descriptions_pt.properties)
+1. [Swedish](https://github.com/svendiedrichsen/jollyday/blob/master/src/main/resources/descriptions/holiday_descriptions_sv.properties)
+
+Feel free to extent this list by providing additional language support files.
+
+To enable localization, 
+
+* copy the file for your language to your OH setup.
+  * again a folder in `$OH_CONF` folder, such as `$OH_CONF/services` is proposed.
+* use function 'Ephemeris.getHolidayDescription' to convert the name according to your localization file.
+
 ## Installable Actions
 
 The following actions are available as installable add-ons.