> For the complete documentation index, see [llms.txt](https://nirsland.gitbook.io/morecreativetabs-reborn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://nirsland.gitbook.io/morecreativetabs-reborn/replacing-a-vanilla-mod-tab.md).

# Replacing a Vanilla/Mod Tab

This feature allows you to replace an existing Creative Tab, with your own custom one. This is an alternative to disabling a tab.

***

#### Example layout of a replaced Tab

In this example, we replace the `Building Blocks` tab, with a custom one.

```json
{
  "tab_enabled": true,
  "tab_name": "building_new",
  "tab_replace": "itemgroup.building_blocks",
  "tab_stack": { "name": "minecraft:torch" },
  "tab_items": [
    {
      "name": "minecraft:soul_torch",
      "nbt": "{customName: \"Oi Govener!\"}"
    }
  ]
}
```

Now, you will notice this layout is almost exactly the same as the layout for Custom Tabs.

But look closely, the important thing here is this: `"tab_replace": "itemgroup.building_blocks"`

This setting, replaces the `Building Blocks` tab with the content of this one. If this setting is not present, it will be loaded as a normal Custom Tab

***

#### Example layout of a Replaced Tab, With Existing and Custom Items

In this example, we replace the `Building Blocks` tab, with a custom one, while still keeping the old items, and adding some of our own.

```json
{
  "tab_enabled": true,
  "tab_name": "building_new",
  "tab_replace": "itemgroup.building_blocks",
  "tab_stack": { "name": "minecraft:torch" },
  "tab_items": [
    {
      "name": "minecraft:soul_torch",
      "nbt": "{customName: \"Oi Govener!\"}"
    },
    {
      "name": "existing"
    }
  ]
}
```

Again, this file looks very similar to the previous example.

The catch here, is the addition of this:

```json
{
  "name": "existing"
}
```

This entry, is a custom entry that tells the mod, that it should add back all the items of the original tab, along with the custom items

You can add a optional `"except"`  parameter to not add items you don't want.

```json
{ 
  "name": "existing", "except": ["minecraft:oak_log", "minecraft:birch_log"]
}
```

This can also be used to remove items from vanilla tabs.

Example:

```json
{
  "tab_enabled": true,
  "tab_replace": "itemgroup.building_blocks",
  "tab_items": [
    {
      "name": "existing", "except": ["minecraft:oak_log", "minecraft:birch_log"]
    }
  ]
}
```

{% hint style="info" %}
"tab\_name", "tab\_stack" and "tab\_items" are optional in creative tab replacement files, but "tab\_enabled", must always be present.
{% endhint %}

**Notice**

Please note that the following tabs cannot be replaced:

* Survival Inventory
* Search