---
title: "new_folder"
description: "Create new folders effortlessly with our guided wizard, customize folder types, and optimize content organization. (Gitana 4.0)"
product: "Gitana"
version: "4.0"
url: "/documentation/gitana/4.0/developers/ui-dev/actions/new_folder"
---

# new\_folder

ID: `new_folder`

This brings up the New Folder wizard that guides users through the process of creating a new folder within the currently viewed folder. This wizard is aware of the currently viewed folder and the current user and derives its behavior based off of those contexts. The newly created folder is created as a child of the current folder.

## Sample Code

```
var UI = require("ui");

var actionContext = {};
UI.startAction(observableHolder, "new_folder", actionContext, function(err) {

    // if something went wrong, err will contain the error
    // otherwise, success

});
```

## Configuration

This action derives some of its behavior from the configuration service.

### Types

By default, this wizard will create child folders of type `Node` (`n:node`). Users can elect to customize the content type of child folders.

The content type list can be customized using the configuration service. Use the `types` array to specify the content types that this dialog should let editors pick from, like this:

```
{
    "new-folder": {
        "remove": true,
        "types": [{
            "qname": "my:photosFolder",
            "title": "Photos Folder"
        }, {
            "qname": "my:videosFolder",
            "title": "Videos Folder"
        }]
    }
}
```

Suppose, for example, that you want these folder types to be available as sub-folders for folders of type `my:mediaFolder`. You could do something like the following:

```
{
    "evaluator": "context-document-has-type",
    "condition": "my:mediaFolder",
    "config": {
        "new-folder": {
            "remove": true,            
            "types": [{
                "qname": "my:photosFolder",
                "title": "Photos Folder"
            }, {
                "qname": "my:videosFolder",
                "title": "Videos Folder"
            }]
        }
    }
}
```

### Other Options

The following additional options are available:

- `pickTypeDefault` - specifies whether the type picker checkbox is selected by default.
- `typeDefault` - specifies the default value you'd like to have picked from the list.

For example, you might do the following:

```
{
    "evaluator": "context-document-has-type",
    "condition": "my:mediaFolder",
    "config": {
        "new-folder": {
            "remove": true,            
            "types": [{
                "qname": "my:photosFolder",
                "title": "Photos Folder"
            }, {
                "qname": "my:videosFolder",
                "title": "Videos Folder"
            }],
            "pickTypeDefault": true,
            "typeDefault": "my:videosFolder"
        }
    }
}
```

This will make it so that the Videos Folder is picked by default.