Type object
File match block-metadata.json
Schema URL https://catalog.lintel.tools/schemas/schemastore/block-protocol-metadata/latest.json
Source https://blockprotocol.org/schemas/block-metadata.json

Validate with Lintel

npx @lintel/lintel check
Type: object

Properties

blockType object required

The type of block this is (e.g. custom element, React)

2 nested properties
entryPoint string required
Values: "custom-element" "html" "react"
tagName string
name string required

A unique, slugified name for the block.

protocol string required

The applicable block protocol version, e.g. 0.3

schema string required

The versioned URL to the block's schema, e.g. https://blockprotocol.org/@blockprotocol/types/entity-type/thing/v/2

source string required

The path or URL to the entrypoint source file (e.g. index.html, index.js).

version string required

The version of the block, which should use semantic versioning (@see https://semver.org/).

author string

The name of the author of the block

commit string

The commit hash of the source this block was built from. If specified, 'repository' must also be specified.

description string

A short description of the block, to help users understand its capabilities

devReloadEndpoint string

URL of a web socket that reports updates in locally developed blocks. To be used by EAs to auto reload.

displayName string

The display name used for a block

examples JsonObject[]

A list of examples property objects which comply with the block's schema, for demonstration purposes

icon string

An icon for the block, to be displayed when the user is selecting from available blocks (as well as elsewhere as appropriate, e.g. in a website listing the block).

image string

A preview image of the block for users to see it in action before using it. This would ideally have a 3:2 width:height ratio and be a minimum of 900x1170px.

license string

The license the block is made available under (e.g. MIT).

repository object | string
variants object[]

A list which represents different variants of the block that the user can create.

Definitions

BlockMetadataRepository object | string
JsonValue JsonValue[] | JsonObject | string | number | boolean