diff --git a/doc/source/users/index.rst b/doc/source/users/index.rst
index cc23d9a6b..498c6c327 100644
--- a/doc/source/users/index.rst
+++ b/doc/source/users/index.rst
@@ -84,6 +84,7 @@ but listed below are the ones provided by this SDK by default.
    Message v1 <proxies/message_v1>
    Message v2 <proxies/message_v2>
    Network <proxies/network>
+   Metric <proxies/metric>
    Object Store <proxies/object_store>
    Orchestration <proxies/orchestration>
    Telemetry <proxies/telemetry>
diff --git a/doc/source/users/proxies/metric.rst b/doc/source/users/proxies/metric.rst
new file mode 100644
index 000000000..3abd98f9d
--- /dev/null
+++ b/doc/source/users/proxies/metric.rst
@@ -0,0 +1,18 @@
+Metric API
+==========
+
+.. automodule:: openstack.metric.v1._proxy
+
+The Metric Class
+----------------
+
+The metric high-level interface is available through the ``metric``
+member of a :class:`~openstack.connection.Connection` object.  The
+``metric`` member will only be added if the service is detected.
+
+Capability Operations
+^^^^^^^^^^^^^^^^^^^^^
+
+.. autoclass:: openstack.metric.v1._proxy.Proxy
+
+   .. automethod:: openstack.metric.v1._proxy.Proxy.capabilities