diff --git a/doc/user-guide-admin/ch_dashboard.xml b/doc/user-guide-admin/ch_dashboard.xml
index fa707eff18..553c74b9bd 100644
--- a/doc/user-guide-admin/ch_dashboard.xml
+++ b/doc/user-guide-admin/ch_dashboard.xml
@@ -35,5 +35,7 @@
     <?hard-pagebreak?>
     <xi:include href="section_dashboard_admin_manage_resources.xml"/>
     <?hard-pagebreak?>
+    <xi:include href="section_dashboard_admin_manage_host_aggregates.xml"/>
+    <?hard-pagebreak?>
     <xi:include href="section_dashboard_admin_manage_stacks.xml"/>
 </chapter>
diff --git a/doc/user-guide-admin/section_dashboard_admin_manage_host_aggregates.xml b/doc/user-guide-admin/section_dashboard_admin_manage_host_aggregates.xml
new file mode 100644
index 0000000000..805d445d52
--- /dev/null
+++ b/doc/user-guide-admin/section_dashboard_admin_manage_host_aggregates.xml
@@ -0,0 +1,161 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<section xmlns="http://docbook.org/ns/docbook"
+  xmlns:xi="http://www.w3.org/2001/XInclude"
+  xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
+  xml:id="dashboard_manage_host_aggregates">
+  <?dbhtml stop-chunking?>
+  <title>Create and manage host aggregates</title>
+  <para>Host aggregates enable administrative users to assign
+    key-value pairs to groups of machines.</para>
+  <para>Each node can have multiple aggregates and each aggregate can
+    have multiple key-value pairs. You can assign the same key-value
+    pair to multiple aggregates.</para>
+  <para>The scheduler uses this information to make scheduling
+    decisions. For information, see <link
+      xlink:href="http://docs.openstack.org/trunk/config-reference/content/section_compute-scheduler.html">
+      <citetitle>Scheduling</citetitle></link>.</para>
+  <procedure>
+    <title>To create a host aggregate</title>
+    <step>
+      <para>Log in to the dashboard.</para>
+      <para>Choose the <guilabel>admin</guilabel> project from the
+          <guilabel>CURRENT PROJECT</guilabel> drop-down list.</para>
+    </step>
+    <step>
+      <para>On the <guilabel>Admin</guilabel> tab, click the
+          <guilabel>Host Aggregates</guilabel> category.</para>
+    </step>
+    <step>
+      <para>Click <guibutton>Create Host Aggregate</guibutton>.</para>
+    </step>
+    <step>
+      <para>In the <guilabel>Create Host Aggregate</guilabel> window,
+        enter or select the following values:</para>
+      <informaltable rules="all" width="85%">
+        <col width="25%"/>
+        <col width="75%"/>
+        <thead>
+          <tr>
+            <th colspan="2" align="center">
+              <guilabel>Host Aggregate Info</guilabel> tab</th>
+          </tr>
+        </thead>
+        <tbody>
+          <tr>
+            <td><para><guilabel>Name</guilabel></para>
+            </td>
+            <td><para>The host aggregate name.</para>
+            </td>
+          </tr>
+          <tr>
+            <td><para><guilabel>Availability Zone</guilabel></para>
+            </td>
+            <td><para>The cloud provider defines the default
+                availability zone, such as <literal>us-west</literal>,
+                  <literal>apac-south</literal>, or
+                  <literal>nova</literal>.</para>
+              <note>
+                <para>You can target the host aggregate, as
+                  follows:</para>
+                <itemizedlist>
+                  <listitem>
+                    <para>When the host aggregate is exposed as an
+                      availability zone, select the availability zone
+                      when you launch an instance.</para>
+                  </listitem>
+                  <listitem>
+                    <para>When the host aggregate is not exposed as an
+                      availability zone, select a flavor and its extra
+                      specs to target the host aggregate.</para>
+                  </listitem>
+                </itemizedlist>
+              </note>
+            </td>
+          </tr>
+        </tbody>
+      </informaltable>
+      <informaltable rules="all" width="85%">
+        <col width="25%"/>
+        <col width="75%"/>
+        <thead>
+          <tr>
+            <th colspan="2" align="center">
+              <guilabel>Host within Aggregate</guilabel> tab</th>
+          </tr>
+        </thead>
+        <tbody>
+          <tr>
+            <td><para><guilabel>Selected hosts</guilabel></para>
+            </td>
+            <td><para>To assign a host to the aggregate, click
+                  <guilabel>+</guilabel> for the host. The host moves
+                from the <guilabel>All available hosts</guilabel> list
+                to the <guilabel>Selected hosts</guilabel>
+                list.</para>
+              <note>
+                <para>You can add one host to one or more aggregates.
+                  To add a host later, edit the aggregate.</para>
+              </note>
+            </td>
+          </tr>
+        </tbody>
+      </informaltable>
+    </step>
+  </procedure>
+  <procedure>
+    <title>To manage host and aggregates</title>
+    <step>
+      <para>Log in to the dashboard.</para>
+      <para>Choose the <guilabel>admin</guilabel> project from the
+          <guilabel>CURRENT PROJECT</guilabel> drop-down list.</para>
+    </step>
+    <step>
+      <para>On the <guilabel>Admin</guilabel> tab, click the
+          <guilabel> Host Aggregates</guilabel> category.</para>
+    </step>
+    <step>
+      <para>To edit host aggregates:</para>
+      <substeps>
+        <step>
+          <para>Select the host aggregate that you want to edit. Click
+              <guibutton>Edit Host Aggregate</guibutton>.</para>
+        </step>
+        <step>
+          <para>In the <guilabel>Edit Host Aggregate</guilabel>
+            window, you can change the name and availability zone for
+            the aggregate.</para>
+        </step>
+      </substeps>
+    </step>
+    <step>
+      <para>To manage hosts:</para>
+      <substeps>
+        <step>
+          <para>Select the host aggregate that you want to edit. Click
+              <guibutton>More</guibutton>.</para>
+        </step>
+        <step>
+          <para>In the <guilabel>Add/Remove Hosts to
+              Aggregate</guilabel> window, click
+              <guilabel>+</guilabel> to assign a host to the
+            aggregate.</para>
+          <para>Click <guilabel>-</guilabel> to remove a host that is
+            assigned to an aggregate.</para>
+        </step>
+      </substeps>
+    </step>
+    <step>
+      <para>To delete host aggregates:</para>
+      <substeps>
+        <step>
+          <para>Select the host aggregate that you want to edit. Click
+              <guibutton>More</guibutton>.</para>
+        </step>
+        <step>
+          <para>Click the <guilabel>Delete Host Aggregate</guilabel>
+            option.</para>
+        </step>
+      </substeps>
+    </step>
+  </procedure>
+</section>