diff --git a/docs/sources/docker-hub/accounts.md b/docs/sources/docker-hub/accounts.md
index 360eb371f395dc067ce7d7164dd8352c58b2db0d..510111f8ef80ce756bd3abf9b5e9580bb453a865 100644
--- a/docs/sources/docker-hub/accounts.md
+++ b/docs/sources/docker-hub/accounts.md
@@ -34,21 +34,50 @@ page.
 
 ## Organizations and groups
 
-Also available on the Docker Hub are organizations and groups that allow
-you to collaborate across your organization or team. You can see what
-organizations [you belong to and add new organizations](
+A Docker Hub organization contains public and private repositories just like
+a user account. Access to push, pull or create these organisation owned repositories
+is allocated by defining groups of users and then assigning group rights to
+specific repositories. This allows you to distribute limited access
+Docker images, and to select which Docker Hub users can publish new images.
+
+### Creating and viewing organizations
+
+You can see what organizations [you belong to and add new organizations](
 https://hub.docker.com/account/organizations/) from the Account Settings
-tab. They are also listed below your user name on your repositories page and in your account profile.
+tab. They are also listed below your user name on your repositories page
+and in your account profile.
 
 ![organizations](/docker-hub/hub-images/orgs.png)
 
-From within your organizations you can create groups that allow you to
-further manage who can interact with your repositories.
+### Organization groups
+
+Users in the `Owners` group of an organization can create and modify the
+membership of groups.
+
+Unless they are the organization's `Owner`, users can only see groups of which they
+are members.
 
 ![groups](/docker-hub/hub-images/groups.png)
 
-You can add or invite users to join groups by clicking on the organization and then clicking the edit button for the group to which you want to add members. Enter a user-name (for current Hub users) or email address (if they are not yet Hub users) for the person you want to invite. They will receive an email invitation to join the group.
+### Repository group permissions
+
+Use organization groups to manage who can interact with your repositories.
+
+You need to be a member of the organization's `Owners` group to create a new group,
+Hub repository or automated build. As an `Owner`, you then delegate the following
+repository access rights to groups:
+
+- `Read` access allows a user to view, search, and pull a private repository in the
+  same way as they can a public repository.
+- `Write` access users are able to push to non-automated repositories on the Docker
+  Hub.
+- `Admin` access allows the user to modify the repositories "Description", "Collaborators" rights,
+  "Mark as unlisted", "Public/Private" status and "Delete".
+
+> **Note**: A User who has not yet verified their email address will only have
+> `Read` access to the repository, regardless of the rights their group membership
+>  gives them.
 
-![invite members](/docker-hub/hub-images/invite.png)
+![Organization repository collaborators](/docker-hub/hub-images/org-repo-collaborators.png)
 
 
diff --git a/docs/sources/docker-hub/hub-images/groups.png b/docs/sources/docker-hub/hub-images/groups.png
index 0c6430efabb939f19cd45b83b43e04814f171b1e..7b4b1b15314c6e455fb06fb03a40e9fbe43ab70a 100644
Binary files a/docs/sources/docker-hub/hub-images/groups.png and b/docs/sources/docker-hub/hub-images/groups.png differ
diff --git a/docs/sources/docker-hub/hub-images/invite.png b/docs/sources/docker-hub/hub-images/invite.png
index 0a157ffbf0cc6a5f0e01dfe574c5c8112c46f02e..c75af366e38259d25533a7e7f6e697eb922457a0 100644
Binary files a/docs/sources/docker-hub/hub-images/invite.png and b/docs/sources/docker-hub/hub-images/invite.png differ
diff --git a/docs/sources/docker-hub/hub-images/org-repo-collaborators.png b/docs/sources/docker-hub/hub-images/org-repo-collaborators.png
new file mode 100644
index 0000000000000000000000000000000000000000..fdb53f7b63f3547a185456cc560a2d6a4ca04209
Binary files /dev/null and b/docs/sources/docker-hub/hub-images/org-repo-collaborators.png differ