vss-extension.json
Azure DevOps Extensions
vss-extension.json
Validate
Check your file against this schema
Opens the validator with this schema already loaded. Paste your
vss-extension.json and it validates in your browser — nothing is uploaded.
Reference
Fields
Generated directly from the schema, following local
$refs, to two levels of nesting.
| Field | Type | Description |
|---|---|---|
manifestVersionrequired | integer | This should be 1. default: 1one of: 1 |
idrequired | string | This is a string that must be unique among extensions from the same publisher. |
versionrequired | string | Should be in the format major.minor.patch, for example 0.1.2 or 1.0.0. You can also add a fourth number for the following format: 0.1.2.3 |
namerequired | string | — |
publisherrequired | string | This identifier must match the identifier the extension is published under. |
categoriesrequired | array<string> | At least one category must be provided and there is no limit to how many categories you may include. |
targetsrequired | array<object> | — |
scopes | array<string> | An array of authorization scopes (strings) listing permissions required by your extension. |
demands | array<string> | An array of demands (strings) listing the capabilities required by your extension. |
baseUri | string | (Optional) base URL for all relative URLs specified by the extension's contributions. |
description | string | — |
icons | object | Dictionary of icons representing the extension. |
icons.defaultrequired | string | The value must be the path to the icon file in the extension |
tags | array<string> | Array of string tags to help users find your extension. |
galleryFlags | array<string> | Array of string tags to classify your extension within the Visual Studio Marketplace |
licensing | object | More information: https://docs.microsoft.com/en-us/azure/devops/extend/develop/manifest?view=azure-devops#mark-an-extension-as-paid |
galleryproperties | object | More information: https://docs.microsoft.com/en-us/azure/devops/extend/develop/manifest?view=azure-devops#mark-an-extension-as-paid |
screenshots | array<object> | Array of images that could not be included in your **content*. |
content | object | — |
content.detailsrequired | allOf | GitHub Flavored Markdown file which describes the details of the Extension |
content.license | allOf | GitHub Flavored Markdown file which describes the license information of the Extension |
content.pricing | allOf | GitHub Flavored Markdown file which describes the pricing information of the Extension |
links | object | — |
links.getstarted | allOf | First steps, how to setup or use. |
links.learn | allOf | Deeper content to help users better understand your extension or service. |
links.license | allOf | End user license agreement. |
links.privacypolicy | allOf | Privacy policy for an extension. |
links.support | allOf | Get help and support for an extension. |
repository | object | — |
repository.typerequired | string | — one of: "git", "mercurial", "svn", "cvs" |
repository.urirequired | string | — |
badges | array<object> | Array of links to external metadata badges like TravisCI, Appveyor etc from the approved badges sites. |
branding | object | Dictionary of brand-related properties. |
branding.colorrequired | string | Primary color of the extension or publisher; can be a hex (#ff00ff), RGB (rgb(100,200,50)), or supported HTML color names (blue). |
branding.theme | string | Complements the color; use dark for dark branding colors, or light for lighter branding colors. one of: "light", "dark" |
public | boolean | Set to true to make this extension public in the Visual Studio Market Place default: false |
files | array<object> | — |
contributions | array | — |
contributionTypes | array | — |
Audit
What we found in this schema
- Declared draft: draft-07
- Validates cleanly against its own meta-schema.
- 69 properties, 74% carrying a description, max nesting depth 8.
Standards
Specification sections for the keywords in this schema
| Keyword | Document | Section |
|---|---|---|
$comment | JSON Schema Core, draft 2020-12 | §8.3 — Comments With "$comment" |
$id | JSON Schema Core, draft 2020-12 | §8.2.1 — The "$id" Keyword |
$ref | JSON Schema Core, draft 2020-12 | §8.2.3.1 — Direct References with "$ref" |
$schema | JSON Schema Core, draft 2020-12 | §8.1.1 — "$schema" |
allOf | JSON Schema Core, draft 2020-12 | §10.2.1.1 — "allOf" |
default | JSON Schema Validation, draft 2020-12 | §9.2 — "default" |
description | JSON Schema Validation, draft 2020-12 | §9.1 — "title" and "description" |
enum | JSON Schema Validation, draft 2020-12 | §6.1.2 — "enum" |
examples | JSON Schema Validation, draft 2020-12 | §9.5 — "examples" |
format | JSON Schema Validation, draft 2020-12 | §7 — Vocabularies for Semantic Content With "format" |
items | JSON Schema Core, draft 2020-12 | §10.3.1.2 — "items" |
maxLength | JSON Schema Validation, draft 2020-12 | §6.3.1 — "maxLength" |
minItems | JSON Schema Validation, draft 2020-12 | §6.4.2 — "minItems" |
pattern | JSON Schema Validation, draft 2020-12 | §6.3.3 — "pattern" |
properties | JSON Schema Core, draft 2020-12 | §10.3.2.1 — "properties" |
required | JSON Schema Validation, draft 2020-12 | §6.5.3 — "required" |
type | JSON Schema Validation, draft 2020-12 | §6.1.1 — "type" |
format: "uri" | RFC 3986 (STD 66) | §3 — Syntax Components |
format: "uri-reference" | RFC 3986 (STD 66) | §4.1 — URI Reference |
Documents
- JSON Schema Core, draft 2020-12 — JSON Schema: A Media Type for Describing JSON Documents, A. Wright, H. Andrews, B. Hutton, G. Dennis, Eds., 2022. draft-bhutton-json-schema-01. An expired Internet-Draft with no formal standing in the IETF standards process; it is nonetheless the specification of record for JSON Schema 2020-12, published by json-schema.org.
- JSON Schema Validation, draft 2020-12 — JSON Schema Validation: A Vocabulary for Structural Validation of JSON, A. Wright, H. Andrews, B. Hutton, Eds., 2022.
- RFC 8259 (STD 90) — The JavaScript Object Notation (JSON) Data Interchange Format, T. Bray, Ed., 2017. The format a schema describes.
- RFC 6901 — JavaScript Object Notation (JSON) Pointer. Defines the pointer syntax used by $ref fragments and the ~0 / ~1 escapes.
Source
Attribution
This schema comes from SchemaStore, distributed under the Apache License 2.0. Copyright 2015–present Mads Kristensen and contributors. View the original file. The field table and audit on this page are generated by JSONTools.tools; the schema itself is unmodified.