diff --git a/firstapp/samples/shade/shade.yml b/firstapp/samples/shade/shade.yml
new file mode 100644
index 000000000..6020e2faa
--- /dev/null
+++ b/firstapp/samples/shade/shade.yml
@@ -0,0 +1,7 @@
+my-provider:
+    profile: $PROVIDER_NAME
+    auth:
+        username: $YOUR_USERNAME
+        password: $YOUR_PASSWORD
+        project_name: $YOUR_PROJECT
+    region_name: $REGION
diff --git a/firstapp/source/getting_started.rst b/firstapp/source/getting_started.rst
index f67a09682..b83963702 100644
--- a/firstapp/source/getting_started.rst
+++ b/firstapp/source/getting_started.rst
@@ -305,6 +305,16 @@ to run code snippets in your language of choice.
               you can avoid specifying :code:`auth_url:` and instead specify
               :code:`profile: $PROVIDER_NAME` in the clouds.yml file.
 
+    To configure shade using a profile, use your credentials above to specify the cloud provider
+    name, username, password, project name, and region name in the file
+    :file:`~/.config/openstack/clouds.yml`.
+
+    .. literalinclude:: ../samples/shade/shade.yml
+        :language: yaml
+
+    See `configure shade <http://git.openstack.org/cgit/openstack/os-client-config/tree/README.rst>`_,
+    to configure your cloud using a profile.
+
     .. literalinclude::  ../samples/shade/getting_started.py
         :start-after: step-1
         :end-before: step-2