Curating collections using namespaces in Automation Hub

Red Hat Ansible Automation Platform 2.1

Use namespaces to organize the collections created by automation developers in your organization. Create namespaces, upload collections and add additional information and resources that help your end users in their automation tasks.

Red Hat Customer Content Services


Providing Feedback:
If you have a suggestion to improve this documentation, or find an error, please contact technical support at to create an issue on the Ansible Automation Platform Jira project using the Docs component.


Curate collections developed in your organization using namespaces in Automation Hub.

Chapter 1. Using namespaces to manage collections in Automation Hub

You can use namespaces in Automation Hub to organize collections developed within your organization for internal distribution and use.

Working with namespaces requires a group that has permissions to create, edit and upload collections to namespaces. Collections uploaded to a namespace may require administrative approval before you can publish them and make them available for use. See Managing user access in Automation Hub for more information on groups and permissions to determine how to configure Automation Hub for your content curators and developers.

1.1. About namespaces

Namespaces are unique locations in Automation Hub to which you can upload and publish content collections. Access to namespaces in Automation Hub is governed by groups with permission to manage the content and related information that appears there.

Formatting collections for your namespaces

You can upload internally developed collections to Automation Hub in tar.gz file format that meet the following name convention:


1.2. Creating a new group for content curators

You can create a new group in Automation Hub designed to support content curation in your organization who will contribute internally developed collections for publication in Automation Hub.

In this section you will create a new group and assign the required permissions to help content developers create namespaces and upload their collections to Automation Hub.


  • You have admin permissions in Automation Hub and create groups.


  1. Log in to your local Automation Hub.
  2. Navigate to Groups and click Create.
  3. Enter Content Engineering as a Name for the group in the modal and click Create. The new group is created and the Groups page will appear.
  4. On the Permissions tab, click Edit.
  5. Under Namespaces add permissions for Add Namespace, Upload to Namespace and Change Namespace.
  6. Click Save.

    The new group is created with the permissions you assigned. Next you can add users to the group.

  7. Click the Users tab on the Groups page.
  8. Click Add.
  9. Select users from the modal and click Add.


You now have a new group who can use Automation Hub to:

  • create a namespace,
  • edit the namespace details and resources page
  • upload internally developed collections to the namespace.

1.3. Creating a namespace

You can create a namespace to use to group collections your developers upload to Automation Hub. When creating a namespace, you can assign a group in Automation Hub as owners of that namespace.


  • You have Add Namespaces and Upload to Namespaces permissions.


  1. Log in to your local Automation Hub.
  2. Navigate to My Namespaces.
  3. Click Create and provide a namespace name and assign a group of Namespace owners.
  4. Click Create.

Your content developers can now proceed to upload collections to your new namespace, or allow users in groups assigned as owners to upload collections.

1.4. Adding additional information and resources to a namespace

You can add information and provide resources for your users to accompany collections included in the namespace. Add a logo, description and link users to your GitHub repository, issue tracker or other online assets. You can also enter markdown text in the Edit resources tab to include additional information helpful to end users who may use your collection in their automation tasks.


  • You have Change Namespaces permissions.


  1. Log in to your local Automation Hub.
  2. Navigate to My Namespaces.
  3. Click More actions and select Edit namespace.
  4. In the Edit details tab, provide information in the fields to enhance your namespace experience.
  5. Click the edit resources tab to enter markdown in the text field.
  6. Click Save when finished.

Your content developers can now proceed to upload collections to your new namespace, or allow users in groups assigned as owners to upload collections.

Once a namespace is created, groups with permissions to upload to it can start adding their collections for approval. Upon approval, collections in the namespace will appear in the Published repository.

1.5. Uploading collections to your namespaces

You can upload internally developed collections to your local Automation Hub namespace for review and approval by an Automation Hub administrator. Once approved, the collection will move to the Published content repository where Automation Hub users can view and download it.


Format your collection file name as follows: <NAMESPACE-COLLECTION-NAME.tar.gz>


  • You have a namespace to which you can upload the collection.


  1. Log in to your local Automation Hub
  2. Navigate to My Namespaces and select a namespace.
  3. Click Upload collection.
  4. Click Select file from the New collection modal.
  5. Select the collection to upload.
  6. Click Upload.

The My Imports screen will provide a summary of tests and notify you if the collection uploaded successfully or failed.

1.6. Reviewing your namespace import logs

You can review the status of collections uploaded to your namespaces to evaluate success or failure of the process.

Imported collections information includes:

  • Status - completed or failed;
  • Approval status - waiting for approval or approved;
  • Version - the version of the uploaded collection.
  • Import log - activities executed during the collection import.


  • You have access to a namespace to which you can upload collections.


  1. Log in to your local Automation Hub.
  2. Navigate to My Namespaces.
  3. Select a namespace.
  4. Click More actions and select My imports.
  5. Use the search field or locate an imported collection from the list.
  6. Click on the imported collection.

Review collection import details to determine the status of the collection in your namespace.

Chapter 2. Conclusion

Following the procedure above, you
  • Create groups with permissions to curate namespaces and upload collections it;
  • Add information and resources to the namespace that helps end users of the collection in their automation tasks;
  • Upload a collection to the namespace.
  • Review the namespace import logs to determine success or failure of uploading the collection and its current approval status.

Legal Notice

Copyright © 2022 Red Hat, Inc.
The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, the Red Hat logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.