Home • Explore • Blog • Models • CI
☰



docker
1st chunk of `content/manuals/extensions/extensions-sdk/extensions/labels.md`
8804a211fab5f5284de8650adcbdb7441289d25a851b616c000000010000099f
---
title: Extension image labels
linkTitle: Add labels
description: Docker extension labels
keywords: Docker, extensions, sdk, labels
aliases: 
 - /desktop/extensions-sdk/extensions/labels/
weight: 10
---

Extensions use image labels to provide additional information such as a title, description, screenshots, and more.

This information is then displayed as an overview of the extension, so users can choose to install it.




You can define [image labels](/reference/dockerfile.md#label) in the extension's `Dockerfile`.

> [!IMPORTANT]
>
> If any of the **required** labels are missing in the `Dockerfile`, Docker Desktop considers the extension invalid and doesn't list it in the Marketplace.


Here is the list of labels you can or need to specify when building your extension:

| Label                                       | Required | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | Example                                                                                                                                                                                                                                                         |
| ------------------------------------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
Title: Docker Extension Image Labels
Summary
Docker extensions use image labels to provide additional information like title, description, and screenshots, which are displayed as an overview of the extension in the marketplace. These labels are defined in the extension's Dockerfile. Missing required labels will cause Docker Desktop to consider the extension invalid.