# Blocks Json

Manages **block styles, patterns and block‑level housekeeping**.

```jsonc
{
  "version": "1.0.2",
  "blocks": {
    "settings": {
      "folders": [
        "/components",
        "/layouts",
        "/query-blocks"
      ],
      "blockCategories": ["structure", "marketing"]
    },

    "styles": {
      "core/button": {
        "Download": {            // label shown in UI
          "inherit": ["core/link", "Download"], // OPTIONAL – re‑uses CSS from another style
          "label": false                        // hide label chip in list view
        },
        "External": {}
      },
      "acf/filters": {
        "Horizontal": {}
      }
    },

    "unregisterStyles": {
      "core/table": ["stripes", "regular"]
    },

    "patterns": {
      "register": {
        "my/event-template": { "title": "Event Template" },
        "my/hero":         { "title": "Hero Section" }
      },
      "categories": ["My Patterns", "Synced"],
      "unregisterCategories": ["core"]
    },

    "unregisterBlocks": ["core/spacer"],
    "dequeueStyles": ["wp-block-navigation", "wp-block-columns"]
  }
}
```

## Keys

| Path                                   | Purpose                                                                                                                                                                                                                                                       |
| -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `version`                              | Cache‑buster for PorterWP.                                                                                                                                                                                                                                    |
| `blocks.settings.folders`              | Additional directories Porter scans when `make.sh` scaffolds a block.                                                                                                                                                                                         |
| `blocks.settings.blockCategories`      | Custom block categories added to the inserter.                                                                                                                                                                                                                |
| `blocks.styles`                        | **Block‑>Style‑>Options**. Valid options:• `inherit` = `[block, style]` to copy another style’s CSS.• `label` = `false` hides the style name in the UI (useful for decorative styles).• Any other key is passed through as an inline setting on registration. |
| `blocks.unregisterStyles`              | Core block styles to unregister.                                                                                                                                                                                                                              |
| `blocks.patterns.register`             | Register block patterns (`title` is mandatory, `description` & `categories` optional).                                                                                                                                                                        |
| `blocks.patterns.categories`           | Add custom pattern categories.                                                                                                                                                                                                                                |
| `blocks.patterns.unregisterCategories` | Remove pattern categories.                                                                                                                                                                                                                                    |
| `blocks.unregisterBlocks`              | Prevent specific blocks appearing in the inserter.                                                                                                                                                                                                            |
| `blocks.dequeueStyles`                 | Stylesheets to dequeue if you roll your own CSS.                                                                                                                                                                                                              |

***

### Example: silent utility style

```jsonc
"styles": {
  "core/group": {
    "Overflow Hidden": { "label": false }
  }
}
```

The style appears in the **Styles** sidebar but carries no visible label on the block. Handy for utility wrappers.

***

⇐ [Back to Config Index](https://whoisandywhite.gitbook.io/porterwp/documentation/configuration-files)