Azure DevOps extension manifest
1.0Schema URL
Base class for extension properties which are shared by the extension manifest and the extension model
Properties
Array of links to external metadata badges like TravisCI, Appveyor, and so on, from the approved badges sites.
Uri used as base for other relative uri's defined in extension
Dictionary of brand-related properties.
2 nested properties
Primary color of the extension or publisher; can be a hex (#ff00ff), RGB (rgb(100,200,50)), or supported HTML color names (blue).
Complements the color; use dark for dark branding colors, or light for lighter branding colors.
Array of strings representing the categories your extension belongs to. At least one category must be provided and there's no limit to how many categories you may include. Valid values: Azure Repos, Azure Boards, Azure Pipelines, Azure Test Plans, and Azure Artifacts.
List of shared constraints defined by this extension
Dictionary of content files that describe your extension to users.
1 nested properties
A content file that describes the extension to users.
1 nested properties
The path to the file in the extension.
List of contribution types defined by this extension
List of contributions made by this extension
List of explicit demands required by this extension
A few sentences describing the extensions. Limited to 200 characters.
Collection of event callbacks - endpoints called when particular extension events occur.
7 nested properties
Base class for an event callback for an extension
1 nested properties
The uri of the endpoint that is hit when an event occurs
Base class for an event callback for an extension
1 nested properties
The uri of the endpoint that is hit when an event occurs
Base class for an event callback for an extension
1 nested properties
The uri of the endpoint that is hit when an event occurs
Base class for an event callback for an extension
1 nested properties
The uri of the endpoint that is hit when an event occurs
Base class for an event callback for an extension
1 nested properties
The uri of the endpoint that is hit when an event occurs
Base class for an event callback for an extension
1 nested properties
The uri of the endpoint that is hit when an event occurs
Base class for an event callback for an extension
1 nested properties
The uri of the endpoint that is hit when an event occurs
Secondary location that can be used as base for other relative uri's defined in extension
The files section is where you reference any files you wish to include in your extension.
Dictionary of icons representing the extension.
1 nested properties
128x128 pixels
The extension's identifier.
Language Culture Name set by the Gallery
How an extension should handle including contributions based on licensing
1 nested properties
A list of contributions which deviate from the default licensing behavior
Version of the extension manifest format/content. Should be 1.
A short, human-readable name of the extension. Limited to 200 characters.
Dictionary of links that help users learn more about your extension, get support, and move.
5 nested properties
1 nested properties
The absolute URL of the link.
1 nested properties
The absolute URL of the link.
1 nested properties
The absolute URL of the link.
1 nested properties
The absolute URL of the link.
1 nested properties
The absolute URL of the link.
The identifier of the publisher. This identifier must match the identifier the extension is published under.
Dictionary of properties describing the source code repository for the extension.
2 nested properties
Type of repository. Example: git.
Absolute URL of the repository.
Default user claims applied to all contributions (except the ones which have been specified restrictedTo explicitly) to control the visibility of a contribution.
List of all oauth scopes required by this extension
Array of images that couldn't be included in your content.
The ServiceInstanceType(Guid) of the VSTS service that must be available to an account in order for the extension to be installed
Array of string tags to help users find your extension.
A string specifying the version of an extension. Should be in the format major.minor.patch.
Definitions
A link to external metadata badge.
The absolute URL of the badge image to be displayed.
Link the user navigates to when selecting the badge.
Description of the badge, to be displayed on hover.
A content file that describes the extension to users.
The path to the file in the extension.
An individual contribution made by an extension
Fully qualified identifier of the contribution/type
The ids of the contribution(s) that this contribution targets. (parent contributions)
Id of the Contribution Type
List of constraints (filters) that should be applied to the availability of this contribution
Description of the contribution/type
Includes is a set of contributions that should have this contribution included in their targets list.
Properties/attributes of this contribution
List of demanded claims in order for the user to see this contribution (like anonymous, public, member...).
VisibleTo can be used to restrict whom can reference a given contribution/type. This value should be a list of publishers or extensions access is restricted too. Examples: "ms" - Means only the "ms" publisher can reference this. "ms.vss-web" - Means only the "vss-web" extension from the "ms" publisher can reference this.
Specifies a constraint that can be used to dynamically include/exclude a given contribution
An optional property that can be specified to group constraints together. All constraints within a group are AND'd together (all must be evaluate to True in order for the contribution to be included). Different groups of constraints are OR'd (only one group needs to evaluate to True for the contribution to be included).
Fully qualified identifier of a shared constraint
If true, negate the result of the filter (include the contribution if the applied filter returns false instead of true)
Name of the IContributionFilter plugin
Properties that are fed to the contribution filter class
Constraints can be optionally be applied to one or more of the relationships defined in the contribution. If no relationships are defined then all relationships are associated with the constraint. This means the default behaviour will eliminate the contribution from the tree completely if the constraint is applied.
Represents different ways of including contributions based on licensing
Description about a property of a contribution type
Description of the property
Name of the property
True if this property is required
The type of value used for a property
The type of value used for a property
A contribution type, given by a json schema
Description of the contribution/type
Fully qualified identifier of the contribution/type
Controls whether or not contributions of this type have the type indexed for queries. This allows clients to find all extensions that have a contribution of this type. NOTE: Only TrustedPartners are allowed to specify indexed contribution types.
Friendly name of the contribution/type
Describes the allowed properties for this contribution type
VisibleTo can be used to restrict whom can reference a given contribution/type. This value should be a list of publishers or extensions access is restricted too. Examples: "ms" - Means only the "ms" publisher can reference this. "ms.vss-web" - Means only the "vss-web" extension from the "ms" publisher can reference this.
Base class for an event callback for an extension
The uri of the endpoint that is hit when an event occurs
Collection of event callbacks - endpoints called when particular extension events occur.
Base class for an event callback for an extension
1 nested properties
The uri of the endpoint that is hit when an event occurs
Base class for an event callback for an extension
1 nested properties
The uri of the endpoint that is hit when an event occurs
Base class for an event callback for an extension
1 nested properties
The uri of the endpoint that is hit when an event occurs
Base class for an event callback for an extension
1 nested properties
The uri of the endpoint that is hit when an event occurs
Base class for an event callback for an extension
1 nested properties
The uri of the endpoint that is hit when an event occurs
Base class for an event callback for an extension
1 nested properties
The uri of the endpoint that is hit when an event occurs
Base class for an event callback for an extension
1 nested properties
The uri of the endpoint that is hit when an event occurs
How an extension should handle including contributions based on licensing
A list of contributions which deviate from the default licensing behavior
Path to resource on disk, which can be relative to your root directory.
(optional) Set to true if you want your file to be URL-addressable. Defaults to false.
(optional) Path to the resource within the package. Defaults to the relative path on disk from your root directory.
(optional) MIME type of the file. Defaults to a best guess based on the file extension and OS settings.
(optional) Specify the value of the Type attribute of the asset entry in the VSIX manifest. Can also be an array of strings, in which case multiple asset entries get added for this file. Defaults to the packagePath.
(optional) Language of this asset. Localized files are served based on the Accept-Language header. Leave blank to signify this file is in the default (or fallback) language. Localized versions of the same file should have the same assetType.
Maps a contribution to a licensing behavior
Represents different ways of including contributions based on licensing
Fully qualified contribution id which we want to define licensing behavior for
The absolute URL of the link.