diff --git a/docs/ALIASES.md b/docs/ALIASES.md
index 1010ad4c..6fe8f2ad 100644
--- a/docs/ALIASES.md
+++ b/docs/ALIASES.md
@@ -35,6 +35,8 @@ var secondFeatureFlag = 'second-flag-key'
 
 Aliases can be hardcoded using the `literal` type. This is intended to be used for testing aliasing functionality.
 
+Note that literal aliases are limited to flag keys using lowercase letters only, due to a limitation of a dependency LaunchDarkly uses to parse the configuration file. [You can track the issue here](https://github.com/spf13/viper/issues/1014).
+
 Example hardcoding aliases for a couple flags:
 
 ```yaml