Optimizing Docker Hub Repository Information for Discoverability

--- description: Learn how to describe and optimize your Docker Hub repositories for better discoverability. keywords: Docker Hub, Hub, repository information, repository discoverability, best practices title: Repository information toc_max: 3 weight: 40 aliases: - /docker-hub/repos/categories/ --- Each repository can include a description, an overview, and categories to help users understand its purpose and usage. Adding clear repository information ensures that others can find your images and use them effectively. You can only modify the repository information of repositories that aren't archived. If a repository is archived, you must unarchive it to modify the information. For more details, see [Unarchive a repository](../archive.md#unarchive-a-repository). ## Repository description The description appears in search results when using the `docker search` command and in the search results on Docker Hub. Consider the following repository description best practices. - Summarize the purpose. Clearly state what the image does in a concise and specific manner. Make it clear if it's for a particular application, tool, or platform, or has a distinct use case. - Highlight key features or benefits. Briefly mention the primary benefits or unique features that differentiate the image. Examples include high performance, ease of use, lightweight build, or compatibility with specific frameworks or operating systems. - Include relevant keywords. Use keywords that users may search for to increase visibility, such as technology stacks, use cases, or environments. - Keep it concise. The description can be a maximum of 100 characters. Aim to stay within one or two sentences for the description to ensure it's easy to read in search results. Users should quickly understand the image's value. - Focus on the audience. Consider your target audience (developers, system administrators, etc.) and write the description to address their needs directly. Following these practices can help make the description more engaging and effective in search results, driving more relevant traffic to your repository. ### Add or update a repository description 1. Sign in to [Docker Hub](https://hub.docker.com). 2. Select **My Hub** > **Repositories**. A list of your repositories appears. 3. Select a repository. The **General** page for the repository appears. 4. Select the pencil icon under the description field. 5. Specify a description. The description can be up to 100 characters long. 6. Select **Update**. ## Repository overview An overview describes what your image does and how to run it. It displays in the public view of your repository when the repository has at least one image. If automated builds are enabled, the overview will be synced from the source code repository's `README.md` file on each successful build. Consider the following repository overview best practices. - Describe what the image is, the features it offers, and why it should be used.

This document explains how to optimize Docker Hub repositories to improve their visibility and ensure users understand their purpose. It covers adding and updating repository descriptions and overviews, providing best practices for each. Repository descriptions, which appear in search results, should be concise, highlight key features, and include relevant keywords. Repository overviews, displayed on the repository's public page, should describe the image's function and usage.