diff --git a/docs/ALIASES.md b/docs/ALIASES.md
index 1010ad4c..f5f06c72 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.
 
+Please note: literal aliases are limited to flag keys using lowercase only because of a limitation of a dependency we use 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