diff --git a/SUMMARY.adoc b/SUMMARY.adoc
index 78d59dd42a..dee3d055f2 100755
--- a/SUMMARY.adoc
+++ b/SUMMARY.adoc
@@ -80,6 +80,7 @@
  . link:topics/events.adoc[Auditing and Events]
  . link:topics/ldap.adoc[LDAP/AD Integration]
  . link:topics/export-import.adoc[Export and Import]
+ . link:topics/account.adoc[User Account Service]
  . link:topics/security-vulnerabilities.adoc[Security Vulnerabilities]
  . link:topics/MigrationFromOlderVersions.adoc[Migration from older versions]
  . link:topics/cors.adoc[CORS]
diff --git a/keycloak-images/account-service-apps.png b/keycloak-images/account-service-apps.png
new file mode 100644
index 0000000000..8291879b59
Binary files /dev/null and b/keycloak-images/account-service-apps.png differ
diff --git a/keycloak-images/account-service-authenticator.png b/keycloak-images/account-service-authenticator.png
new file mode 100644
index 0000000000..f6e5256a25
Binary files /dev/null and b/keycloak-images/account-service-authenticator.png differ
diff --git a/keycloak-images/account-service-federated-identity.png b/keycloak-images/account-service-federated-identity.png
new file mode 100644
index 0000000000..7f55131245
Binary files /dev/null and b/keycloak-images/account-service-federated-identity.png differ
diff --git a/keycloak-images/account-service-password.png b/keycloak-images/account-service-password.png
new file mode 100644
index 0000000000..4a269cc3ae
Binary files /dev/null and b/keycloak-images/account-service-password.png differ
diff --git a/keycloak-images/account-service-profile.png b/keycloak-images/account-service-profile.png
new file mode 100644
index 0000000000..604f3c5018
Binary files /dev/null and b/keycloak-images/account-service-profile.png differ
diff --git a/keycloak-images/account-service-sessions.png b/keycloak-images/account-service-sessions.png
new file mode 100644
index 0000000000..6f4c4ef291
Binary files /dev/null and b/keycloak-images/account-service-sessions.png differ
diff --git a/rhsso-images/account-service-apps.png b/rhsso-images/account-service-apps.png
new file mode 100644
index 0000000000..9543a2c942
Binary files /dev/null and b/rhsso-images/account-service-apps.png differ
diff --git a/rhsso-images/account-service-authenticator.png b/rhsso-images/account-service-authenticator.png
new file mode 100644
index 0000000000..394f8d58e9
Binary files /dev/null and b/rhsso-images/account-service-authenticator.png differ
diff --git a/rhsso-images/account-service-federated-identity.png b/rhsso-images/account-service-federated-identity.png
new file mode 100644
index 0000000000..94c1185938
Binary files /dev/null and b/rhsso-images/account-service-federated-identity.png differ
diff --git a/rhsso-images/account-service-password.png b/rhsso-images/account-service-password.png
new file mode 100644
index 0000000000..2bd3a80219
Binary files /dev/null and b/rhsso-images/account-service-password.png differ
diff --git a/rhsso-images/account-service-profile.png b/rhsso-images/account-service-profile.png
new file mode 100644
index 0000000000..0c9384a193
Binary files /dev/null and b/rhsso-images/account-service-profile.png differ
diff --git a/rhsso-images/account-service-sessions.png b/rhsso-images/account-service-sessions.png
new file mode 100644
index 0000000000..53533937c1
Binary files /dev/null and b/rhsso-images/account-service-sessions.png differ
diff --git a/topics/account.adoc b/topics/account.adoc
new file mode 100644
index 0000000000..58883c0bd2
--- /dev/null
+++ b/topics/account.adoc
@@ -0,0 +1,48 @@
+[[_account-service]]
+
+== User Account Service
+
+{{book.project.name}} has a built in User Account Service which every user has access to.  This service allows users to manage their account,
+change their credentials, update their profile, and view their login sessions.  The URL to this service is `<server-root/auth/realms/\{realm-name}/account`.
+
+.Account Service
+image:../{{book.images}}/account-service-profile.png[]
+
+The initial page is the user's profile, which is the `Account` left menu item.  This is where they specify basic data about themselves.  This screen can be extended
+to allow the user to manage additional attributes.  See the link:{{book.developerguide.link}}[{{book.developerguide.name}}] for more details.
+
+The `Password` left menu item allows the user to change their password.
+
+.Password Update
+image:../{{book.images}}/account-service-password.png[]
+
+The `Authenticator` menu item allows the user to set up OTP if they desire.  This will only show up if OTP is a valid authentication mechanism for your realm.
+Users are given directions to install https://fedorahosted.org/freeotp/[FreeOTP] or https://play.google.com/[Google Authenticator] on their mobile device to be their OTP generator.
+The bar code you see in the screen shot can be scanned into the FreeOTP or Google Authenticator mobile application for nice and easy setup.
+
+.OTP Authenticator
+image:../{{book.images}}/account-service-authenticator.png[]
+
+The `Federated Identity` menu item allows the user to link their account with an <<identity-broker.adoc#_identity-broker, identity broker>> (this is usually used to link social provier
+accounts together).  This will show the list of external identity providers you have configured for your realm.
+
+.Federated Identity
+image:../{{book.images}}/account-service-federated-identity.png[]
+
+The `Sessions` menu item allows the user to view and manage which devices are logged in and from where.  They can perform logout of these sessions from this screen too.
+
+.Sessions
+image:../{{book.images}}/account-service-sessions.png[]
+
+The `Applications` menu item shows users which applications they have access to.
+
+.Applications
+image:../{{book.images}}/account-service-apps.png[]
+
+=== Themeable
+
+Like all UIs in {{book.project.name}} the User Account Service is completely themeable and internationalizable.
+See the link:{{book.developerguide.link}}[{{book.developerguide.name}}] for more details.
+
+
+