diff --git a/doc/config-reference/ch_imageservice.xml b/doc/config-reference/ch_imageservice.xml
index 3e410d4456..1450f4cae3 100644
--- a/doc/config-reference/ch_imageservice.xml
+++ b/doc/config-reference/ch_imageservice.xml
@@ -27,23 +27,17 @@
You can modify many options in the OpenStack Image Service.
The following tables provide a comprehensive list.
-
-
-
-
-
-
-
-
+
+
diff --git a/doc/config-reference/image-service/section_image-service-api.xml b/doc/config-reference/image-service/section_image-service-api.xml
new file mode 100644
index 0000000000..fdb1ab755d
--- /dev/null
+++ b/doc/config-reference/image-service/section_image-service-api.xml
@@ -0,0 +1,24 @@
+
+ Configure the API
+ The Image Service has two APIs: the user-facing API, and
+ the registry API, which is for internal requests that require
+ access to the database.
+ Both of the APIs currently have two major versions, v1 and v2.
+ It is possible to run either or both version, by setting appropriate
+ values of enable_v1_api,
+ enable_v2_api, enable_v1_registry and
+ enable_v2_registry. If the v2 API is used, running
+ glance-registry is optional, as
+ v2 of glance-api
+ can connect directly to the database.
+ Tables of all options used to configure the APIs, including enabling
+ SSL and modifying WSGI settings are found below.
+
+
+
+
diff --git a/doc/config-reference/image-service/section_image-service-rpc.xml b/doc/config-reference/image-service/section_image-service-rpc.xml
new file mode 100644
index 0000000000..944615cb92
--- /dev/null
+++ b/doc/config-reference/image-service/section_image-service-rpc.xml
@@ -0,0 +1,21 @@
+
+ Configure the RPC messaging system
+ OpenStack projects use an open standard for messaging
+ middleware known as AMQP. This messaging middleware enables the
+ OpenStack services that run on multiple servers to talk to each
+ other. The OpenStack common library project, oslo, supports three
+ implementations of AMQP: RabbitMQ,
+ Qpid, and
+ ZeroMQ.
+ The following tables contain settings to configure the
+ messaging middleware for the Image Service:
+
+
+
+
+
+
\ No newline at end of file