diff --git a/src/@ionic-native/plugins/globalization/index.ts b/src/@ionic-native/plugins/globalization/index.ts
index 6ba8e97e30..0acecdd929 100644
--- a/src/@ionic-native/plugins/globalization/index.ts
+++ b/src/@ionic-native/plugins/globalization/index.ts
@@ -4,6 +4,12 @@ import { Cordova, Plugin, IonicNativePlugin } from '@ionic-native/core';
 /**
  * @name Globalization
  * @description
+ * This plugin obtains information and performs operations specific to the user's locale, language, and timezone.
+ *
+ * @deprecated
+ * With the [ECMA Internationalization API](https://www.ecma-international.org/ecma-402/1.0/) now supported on iOS, Android and Windows devices, this plugin is not required any more.
+ * Migrating from this plugin to the [ECMA Internationalization API](https://www.ecma-international.org/ecma-402/1.0/) is explained in this [Cordova blog post](https://cordova.apache.org/news/2017/11/20/migrate-from-cordova-globalization-plugin.html).
+ *
  * @usage
  * ```typescript
  * import { Globalization } from '@ionic-native/globalization';