List

Create a bulleted or numbered list.

This block is available in the latest version of WordPress and does not require the Gutenberg plugin.

Category:

For developers

Block Attributes

Optional. Type: Object.

Attributes provide the structured data needs of a block. They can exist in different forms when they are serialized, but they are declared together under a common interface.

Documentation

{
  "ordered": {
    "type": "boolean",
    "default": false,
    "__experimentalRole": "content"
  },
  "values": {
    "type": "string",
    "source": "html",
    "selector": "ol,ul",
    "multiline": "li",
    "__unstableMultilineWrapperTags": [
      "ol",
      "ul"
    ],
    "default": "",
    "__experimentalRole": "content"
  },
  "type": {
    "type": "string"
  },
  "start": {
    "type": "number"
  },
  "reversed": {
    "type": "boolean"
  },
  "placeholder": {
    "type": "string"
  },
  "anchor": {
    "type": "string",
    "source": "attribute",
    "attribute": "id",
    "selector": "*"
  }
}

Block Supports

Optional. Type: Object.

A set of options that enables or disables block controls in the editor, for example gradient colors or padding.

Documentation

{
  "anchor": true,
  "className": false,
  "typography": {
    "fontSize": true,
    "lineHeight": true,
    "__experimentalFontFamily": true,
    "__experimentalFontWeight": true,
    "__experimentalFontStyle": true,
    "__experimentalTextTransform": true,
    "__experimentalTextDecoration": true,
    "__experimentalLetterSpacing": true,
    "__experimentalDefaultControls": {
      "fontSize": true
    }
  },
  "color": {
    "gradients": true,
    "link": true,
    "__experimentalDefaultControls": {
      "background": true,
      "text": true
    }
  },
  "spacing": {
    "margin": true,
    "padding": true
  },
  "__unstablePasteTextInline": true,
  "__experimentalSelector": "ol,ul",
  "__experimentalSlashInserter": true
}

Transforms

Optional. Type: Object.

Transforms provide rules for what a block can be transformed from and what it can be transformed to.

Documentation

Transforms from: Paragraph, heading.

Transforms to: Paragraph. Heading. Any.