The tree panel creates a visualisation of a Newick file. Multiple basic styles are available, and many details can be configured.

See Tree Data for Tree data source guidance, including hiding all metadata that lacks a matching tree leaf.

Basic tree settings & controls

Tree style

The tree style can be changed by clicking the panel configuration button, and then hovering over the tree button and selecting one of the options

Tree Controls

Leaf Properties

  • If leaf borders are turned on, they will be the same colour as the node unless they have no colour, in which case the border will be dark grey.

  • When turning on the leaf labels, the labels will be shown in a sparse fashion so that overlapping leaf labels are hidden. In order to see all leaf labels, zoom in (see below).

    • When displaying leaf labels only those which do not overlap each other will be displayed. You can think of these as sparse labels. As you zoom in on the tree more labels will be revealed.

  • Align leaf labels: move the labels away from the nodes and place them flush to one another

Internal Properties

  • The internal nodes toggle will display internal nodes if available

  • If internal nodes have label properties, the Internal Labels toggle will turn those on, and the slider will change the label size

    • Filter Internal Nodes is an option when Internal Labels is selected, and will

  • Branch lengths can be displayed and defined using the Branch Lengths toggle & slider

  • The colour internal edges toggle will colour edges connected to leaves using same colour as the connected leaf node

These are coloured shapes added alongside the tips of the tree to show features that differ between samples. This information adds context to the tree, and can help identify sample metadata correlating with genotype.

When adding metadata blocks, the blocks to be displayed can be selected from all available columns, and the metadata block characteristics can be changed.

Caution: once you have saved views in the views sidebar, there is no way for Microreact to know which views you want to apply these colour changes, so you must make the changes and save them on each saved view, using "Update View" option. This effort can be avoided by setting the colours at the start. One robust way to do this is by using the Colour Definition "__colour" option.

Block Headers defines the size of the label font. Block Size defines the width of each block. Block Gap defines the space between blocks, if multiple blocks are added.

Moving and Zooming

Clicking on the white space next to the tree will allow the tree to be dragged around the panel. The tree can be zoomed (in or out) by using a mouse wheel. Holding the control (Windows)/command (Mac) key or alt (Windows)/option (Mac) whilst rotating the mouse wheel will zoom the tree horizontally and vertically respectively.

Clicking the +/- icons zoom in and out, while clicking the central icon determines whether the zooming happens in all directions, horizontally, or vertically.

Manipulating the tree

Hovering to the left of a parent node will highlight all the children node branches in green

Right-clicking on this selected parent node will bring up a contextual menu that allows several functions

View Subtree

This will display just the child nodes of the selected parent node. If you have trouble hovering over the desired child node, zoom in until you can select the desired node to right-click on it.

Collapse subtree

Collapse all the child nodes into a single branch

Rotate subtree

Rotate the child nodes around the selected parent node

Set as Root (Re-root)

Set the selected node as the root of the tree

Export Leaf Labels/Export Newick File

Export the selected subtree as a text list of the leaf label names or as a newick file containing just the subtree.

The features above refer to a subtree. Right-clicking away from tree within the panel will display a contextual menu

Fit in panel

Redraw Original Tree

Clicking on this returns the tree state to it's original topology and displays all the leaves

Midpoint Root

Clicking this enables the tree to be midpoint rooted if it was not rooted prior to upload


The tree can be exported as a text file with a list of leaf labels, a newick file or as a PNG image

Filtering Data

You can filter the tree data by

  • clicking on an internal node in the tree or

  • Filtering on other panels that are linked to the tree (e.g. selecting via the data-slicer)

Last updated