---
title: "deleteShelfTab"
canonical: "https://help.vicon.com/space/ShogunPost121/1253738610/deleteShelfTab"
format: markdown
---
# Description

Deletes the indicated tabs (and the buttons on those tabs).

Use deleteShelfTab when you need to delete a shelf tab and all its component buttons. Indicate tabs by specifying the names of the tabs, or the tab indexes, where index >= 0 and index < NumTabsInShelf.

> ⚠️ **Caution**   
> ⚠️ Because you are changing Shogun Post's interface as opposed to changing any data, this operation is not undo-able. To be safe, back up *scriptShelves.hsl* before running this command.

## Functional area

Interface

# Command syntax

## Syntax

> Macro (scroll-tablelayout)

|  |
| --- |
| `deleteShelfTab "tabNameOrIndex1" ["tabNameOrIndex2..."][-all]` |

### Arguments

> Macro (scroll-tablelayout)

| Name | Type | Required | Comments |
| --- | --- | --- | --- |
| `Index#` |  |  | An integer indicating the index # of the tab to be deleted; more than one Index # may be invoked for deletion |
| `tabName` |  |  | The string name of the shelf tab to be deleted; more than one tabName may be invoked for deletion |

### Flags

See above syntax.

## Return value

void

## Examples

```plaintext
deleteShelfTab 1;
// Deletes the indicated shelf tab(s) and its button contents.
```

# Additional information

## Related commands

- [createShelfButton](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253739490)
- [createShelfTab](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253737931)