# Space

"Spaces" in Mprove are used to create UI catalog trees for reports, charts and dashboards.

`.space` file adds `access_roles` to the actual folder contents. 

Each top level space must be stored as **space_name.space** YAML file:

```yaml
space: space_name
title: ''
access_roles:
- role
- role
folders:
- space: s2
  access_roles:
  - role
  - role
  folders:
  - space: s3
    access_roles: 
    - role
    - role
```

`space_name.space` file must be stored in a folder named `space_name`.

`folders` (subspaces) are optional; they can be useful if certain users need access to a portion of the parent space.

## Reference

### Space

| Name         | Type                                            | Default | Description                                                                  |
| ------------ | ----------------------------------------------- | ------- | ---------------------------------------------------------------------------- |
| space\*      | string                                          | -       | Space name                                                                   |
| title        | string                                          | -       | Space title in UI                                                            |
| access_roles | string []                                       | -       | If specified, only users with the listed roles will have access to the Space |
| folders      | [Space []](/content/docs/reference/space#space) | -       | Begin a section of subspaces                                                 |