# Customize Menus

> How to customize menus using .menu files in Asset Transformer Studio plugins

Reorder menus using `.menu` files.

## Set up

1. Create a `menus` subfolder at your plugin's root folder, next to `plugin.xml`.
2. Create a new file with the .menu extension.

   You can add as many .menu files as you like.

   Icons can be added by adding a .png file to the `icons` subfolder, see the [Toolbar](./_index.md#toolbar) section.

## Syntax

### Menu creation and positioning

1. Create a new menu, position it before an existing one:

   ```xml
   <menu name="Sample" before="Scene">
       …
   </menu>
   ```

   Or edit an existing menu:

   ```xml
   <menu name="Scene">
       …
   </menu>
   ```

2. Create a submenu:

   ```xml
   <menu name="Sample" before="Scene">
       <subMenu name="Pixyz">
           …
       </subMenu>
   </menu>
   ```

3. Add separators:

   ```xml
   …
   <separator/>
   …
   ```

### Function entries

* Add the main plugin function and change its displayed name:

  ```xml
  <action function="SampleFunction" displayName="Sample Function"/>
  ```

* Add existing functions from other modules:

  ```xml
  <action module="Algo" function="tessellate"/>
  ```

* Hide existing functions:

  ```xml
  <action module="Algo" function="decimateTarget" hidden="true"/>
  ```

> **Note:**
>
> The function will be hidden in its original menu.
