# How to use the markup tools
Markups are created by adding different markup elements to it. This includes any combination of markers (points), lines, polygons, circles, symbols, traffic signs and text. Any changes you make are saved automatically in real time.
# Adding markers
To add a marker (point) to your markup, click the 
button. Then click anywhere on the map to add a marker there. Clicking anywhere else on the map will add a new marker.
# Adding geometries (lines and polygons)
To add geometry to your markup click the 
button. Click on the map to place the corners of your shapes or points of your lines. To create polygons, click the first point again.
To start a new geometry, click the New geometry button, or by click the map again after closing off a polygon.
# Adding circles
To add a circle to your markup click the 
button. Click on the map to place the center of your circle. Click and hold the center point of the circle to move it around. You can specify the circle radius in metres in the properties panel.
# Adding text
To add text to your markup click the 
button. Click on the map to specify the insertion point for your text. Type the text to display inside the Label field. You can specify text height (in metres) in the Line height field and rotation of the text (in degrees) by moving the rotation slider.
# Adding symbols and traffic signs
To add a symbol to your markup click the 
button to select the Symbol tool.
Click the button to open the Symbol select dialog. Symbols are organised into groups you can switch between using the tabs at the top:
- Basic: General-purpose icons you can recolor to suit your markup.
- Road signs: Official Australian traffic signs. These keep their standard colors and so may not be recolored.
Choose a tab, pick the symbol you want, then click on the map to place it.
You can move, resize and rotate a symbol directly on the map; see Moving, resizing and rotating features below.
The symbol can be further adjusted by changing the properties in the designer panel. For Basic symbols you can specify stroke weight, stroke color and fill color. Road signs keep their official colors, so color options aren't shown for them.
If you wish to repeat the same styling to subsequent symbols, check the "Copy style to new features" checkbox. Any new symbols created with this checked will have the same stroke weight and colors of the checked symbol.
If you wish to change the symbol, you can select the "symbol select" button to show the symbol selection dialog again.
# Moving, resizing and rotating features
Once a feature is on the map, select it and use the on-map handles to adjust it. The same controls work across every feature type, so each feature behaves the same way. Only the adjustments that make sense for a feature are offered:
| Feature | Move feature | Resize feature | Rotate feature | Move vertex | Create new segment |
|---|---|---|---|---|---|
| Marker (point) | Yes | - | - | - | - |
| Circle | Yes | Yes | - | - | - |
| Line / polygon | Yes | Yes | Yes | Yes | Yes |
| Text | Yes | Yes | Yes | - | - |
| Symbol / road sign | Yes | Yes | Yes | - | - |
For example, a marker only has a location, so it can be moved but not resized or rotated, while a circle can be moved and resized but not rotated. You can also fine-tune values such as circle radius, text height and rotation directly in the properties panel.
The handles for line / polygon features have different appearances for the various adjustments; these are outlined as follows:
| Handle | Function |
|---|---|
| Blue dot with yellow glow | Move feature |
| White square with blue outline | Resize feature |
| White dot with blue outline | Rotate feature |
| Large white dot with yellow glow | Move vertex |
| Small white dot with yellow glow | Create new segment |
# Styling markup features
Most markup features can be styled, usually by colors (stroke and fill) or width (stroke). To style a feature, first select it by clicking on one of the select handles for the feature, the adjust the properties in the properties panel for the feature.
# Removing a feature
To remove a markup feature, first select it by clicking on one of the select handles for the feature, then click the Remove button next to Feature id.
# Sharing a markup
You can share a markup with other users individually, or with entire groups. To share, click the 
button which will open up the permissions dialog. From here, select any individual user or any groups you want to share with, along with the permission level. The permission won't committed until you click Share.
# View only
This permission setting only allows the markup to be viewed (no editing is possible). This permission still allows users to comment on the markup.
# View and edit the markup
This permission setting allows full editing of the markup. This includes adding, removing and styling features as well as changing permissions for the markup. This permission setting does not allow deletion of the markup; only users who created the markup (and project administrators) may do this.
# Next steps
- How to edit a markup: Change features you've already added
- How to view markups: Find and display existing markups
- How to download, comment on and delete markups