diff --git a/context.go b/context.go
index 21d0ae0..57f0801 100644
--- a/context.go
+++ b/context.go
@@ -87,6 +87,10 @@
 
 // ProviderByName will locate a provider amongst those previously registered, if it exists.
 // If the named provider has not been registered, an ErrProvider error will result.
+//
+// You may also specify a custom Identity API URL.
+// Any provider name that contains the characters "://", in that order, will be treated as a custom Identity API URL.
+// Custom URLs, important for private cloud deployments, overrides all provider configurations.
 func (c *Context) ProviderByName(name string) (p Provider, err error) {
 	for provider, descriptor := range c.providerMap {
 		if name == provider {
diff --git a/global_context.go b/global_context.go
index cf5ed8f..45f06f8 100644
--- a/global_context.go
+++ b/global_context.go
@@ -34,6 +34,9 @@
 //
 // Providers are identified through a unique key string.
 // Specifying an unsupported provider will result in an ErrProvider error.
+// However, you may also specify a custom Identity API URL.
+// Any provider name that contains the characters "://", in that order, will be treated as a custom Identity API URL.
+// Custom URLs, important for private cloud deployments, overrides all provider configurations.
 //
 // The supplied AuthOptions instance allows the client to specify only those credentials
 // relevant for the authentication request.  At present, support exists for OpenStack