# URL control options

This section lists project options which can be set via URL query string keys. For example, add `?tt=cr` to the end of a project link to set tree type to circular: <https://microreact.org/project/Ny8H4gsH?tt=cr>. Multiple options can be combined using ampersand character (`&`). For example, add `?tt=cr&tl=0` to the end of a project link to set tree type to circular and hide tree labels.

**Filter URL Options**

| Option | Description            | Default value | Accepted values                                                                                                                      |
| ------ | ---------------------- | ------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| `fb`   | Metadata block columns |               | Sets the initial columns displayed as metadata blocks on the tree. Multiple column names can be combined using comma (`,`) character |
| `fc`   | Colour column          |               | Sets the initial column used to colour nodes                                                                                         |
| `fl`   | Label column           |               | Sets the initial column used for labels                                                                                              |
| `fs`   | Shape column           |               | Sets the initial column used for shapes                                                                                              |

**Map URL Options**

| Option | Description                   | Default value | Accepted values                                                                                                                                                                                                                                                                                                                                       |
| ------ | ----------------------------- | ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `mc`   | Map controls                  | `0`           | `1` to show map controls, or `0` to hide them                                                                                                                                                                                                                                                                                                         |
| `mmns` | Map min node size             | `4`           | Sets the minimal map node size                                                                                                                                                                                                                                                                                                                        |
| `mns`  | Map node size                 | `14`          | Sets the map node size in pixels                                                                                                                                                                                                                                                                                                                      |
| `mxns` | Map max node size             | `160`         | Sets the maximal metadata node size                                                                                                                                                                                                                                                                                                                   |
| `mo`   | Map centre geographical point | `0,0`         | Sets the initial geographic centre of the map. Must be a valid geographical point with a certain latitude and longitude separated with a comma.                                                                                                                                                                                                       |
| `mz`   | Map zoom level                | `1`           | Sets the initial map zoom level.                                                                                                                                                                                                                                                                                                                      |
| `ms`   | Map Mapbox tile style         | `light`       | <p>Sets the initial Mapbox tile style as follows:<br><code>light</code>: Light style<br><code>dark</code>: Dark style<br><code>streets</code>: Streets<br><code>satellite</code>: Satellite<br><code>'</code>saellite-streets': 'Satellite Streets<br><code>basic</code>: Basic<br><code>bright</code>: Bright<br><code>outdoors</code>: Outdoors</p> |

**Layout URL Options**

| Option | Description          | Default value                                                                  | Accepted values                                                                                                                                                                                                                                                                                                                |
| ------ | -------------------- | ------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `ud`   | Details pane view    | `t` (the default value is set to `d` when project does not include a timeline) | <p>Sets the initial view in the details pane as follows:<br><code>d</code>: Data table<br><code>t</code>: Timeline</p>                                                                                                                                                                                                         |
| `uhs`  | Horizontal pane size | `50`                                                                           | Sets the initial size of the horizontal panes, e.g. `40` sets the size of the main pane to 40% of the window height and the details pane to 60%.                                                                                                                                                                               |
| `ui`   | Shape column         | `null`                                                                         | Sets the initial column used for shapes                                                                                                                                                                                                                                                                                        |
| `us`   | Side pane view       |                                                                                | <p>Sets the initial view in the side pane as follows:<br><code>b</code>: Blocks<br><code>c</code>: Colour columns<br><code>e</code>: Network edge styles<br><code>h</code>: Project history<br><code>l</code>: Label columns<br><code>d</code>: Legend<br><code>p</code>: Pattern columns<br><code>s</code>: Shape columns</p> |
| `uvs`  | Vertical pane size   | `68`                                                                           | Sets the initial size of the vertical panes, e.g. `40` sets the size of the map pane to 40% of the window width and tree pane to 60%. See option `ui` above to change the order of the panes.                                                                                                                                  |

**Data Table URL Options**

| Option | Description          | Default value | Accepted values                              |
| ------ | -------------------- | ------------- | -------------------------------------------- |
| `dm`   | Display density mode | `comf`        | <p>Sets the initial display density:<br></p> |

**Timeline URL Options**

| Option | Description            | Default value | Accepted values                                                                                                                                                                             |
| ------ | ---------------------- | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `lc`   | Timeline controls      | `0`           | `1` to show timeline controls, or `0` to hide them                                                                                                                                          |
| `lmns` | Timeline min node size | `1`           | Sets the minimal timeline node size                                                                                                                                                         |
| `lns`  | Timeline node size     | `14`          | Sets the timeline node size in pixels                                                                                                                                                       |
| `lu`   | Time grouping unit     | `year`        | <p>Sets the unit used to group timeline data as follows:<br><code>y</code>: Year<br><code>q</code>: Quarter<br><code>m</code>: Month<br><code>w</code>: Week<br><code>d</code>: Day<br></p> |
| `lxns` | Timeline max node size | `160`         | Sets the maximal timeline node size                                                                                                                                                         |
| `ls`   | Timeline play speed    | `1`           | Sets the interval (in seconds) at which the timeline is played                                                                                                                              |

**Tree URL Options**

| Option | Description           | Default value | Accepted values                                                                                                                                                                                                              |
| ------ | --------------------- | ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `tal`  | Align tree labels     | `0`           | `1` to align tree labels, or otherwise `0`                                                                                                                                                                                   |
| `tbh`  | Show block headers    | `0`           | `1` to show metadata block headers, or `0` to hide them                                                                                                                                                                      |
| `tbl`  | Tree block length     | `6`           | Sets the metadata block length in pixels                                                                                                                                                                                     |
| `tbn`  | Tree branch length    | `0`           | `1` to show tree branch lengths, or `0` to hide them                                                                                                                                                                         |
| `tc`   | Tree controls         | `0`           | `1` to show tree controls, or `0` to hide them                                                                                                                                                                               |
| `tl`   | Tree labels           | `0`           | `1` to show tree labels, or `0` to hide them                                                                                                                                                                                 |
| `tmbl` | Tree min block length | `1`           | Sets the minimal metadata block length                                                                                                                                                                                       |
| `tmns` | Tree min node size    | `1`           | Sets the minimal tree node size                                                                                                                                                                                              |
| `tmts` | Tree min text size    | `1`           | Sets the minimal font size in pixels                                                                                                                                                                                         |
| `tns`  | Tree node size        | `14`          | Sets the tree node size in pixels                                                                                                                                                                                            |
| `tt`   | Tree type             | `rc`          | <p>Sets the initial tree type as follows:<br><code>rc</code>: Rectangular tree<br><code>cr</code>: Circular tree<br><code>rd</code>: Radial tree<br><code>dg</code>: Diagonal tree<br><code>hr</code>: Hierarchical tree</p> |
| `tts`  | Tree text size        | `8`           | Sets the tree font size in pixels                                                                                                                                                                                            |
| `txbl` | Tree max block length | `160`         | Sets the maximal metadata block length                                                                                                                                                                                       |
| `txns` | Tree max node size    | `160`         | Sets the maximal metadata node size                                                                                                                                                                                          |
| `txts` | Tree max text size    | `64`          | Sets the maximal font size in pixels                                                                                                                                                                                         |
