Quick Action

Quick Action Widget is a configurable quick access button on the map with selected actions accessible 'just in 2 clicks'.

In this article

Quick action widget

Enable widget

In order to use the Quick Actions button you need to enable this widget first.

Android: Menu → Configure screen → Quick action

iOS: Menu → Configure screen → Quick action

By default the Quick action button will appear on the right corner (above the zoom buttons), but it can be moved to the any part of the screen by long tap on it.

First appearingQuick action widget_view
Long tap and movingQuick action widget_tap
New placeQuick action widget_move

To open Quick action menu just press on the button.

AndroidiOS
Quick action widget_androidQuick action widget_ios

Edit actions list

Add new action

There are 2 ways to add items to the Quick actions list:

  • Menu → Configure screen → Quick action → …| → Add action(+)
AndroidiOS
Quick action widget_android_addQuick action widget_ios_add
  • Click "Quick action" button → "Quick action" menu → Add action
AndroidiOS
Quick action widget_android_add2Quick action widget_ios_add2

First you need to select type of the action and then you could change its name and parameters (See below which parameters could be configured for each action type). Every action should have a unique name.

Reorder actions

Quick action panel has only 6 slots for actions per screen. However you could have multiple screens and actions are grouped by the specified order. In order to change the order of items:

Android: Menu → Configure screen → Quick action → Hold & Drag selected action up and down by the icon (three vertical lines) in the list

Android: Open Quick action menu → Long tap on 'Add action' → Hold & Drag selected action up and down by the icon (three vertical lines) in the list

iOS: Menu → Configure screen → Quick action → Click Edit (Pencil icon) → Hold & Drag selected action up and down by the icon (three vertical lines) in the list → Done

AndroidiOS
Quick action widget_android_orderQuick action widget_ios_order

Edit / Remove action

There are several ways how to access Quick Action to edit or delete it:

  • Long tap on the action (Android)

    Open Quick action menu → Long tap on the action (short tap to execute the action)

  • Delete via "Edit actions" list

    Android: Menu → Configure screen → Quick action → Click Delete (Bin icon on the right top corner) → Select actions → Delete

    iOS: Menu → Configure screen → Quick action → Click Edit (Pencil icon on the right top corner) → Select actions → Delete

AndroidiOS
Quick action widget_android_delQuick action widget_ios_del

Quick action types

Create items

ActionDescription
Add FavoriteAdds favorite to a selected (center) map location.
- Show an interim dialog: displays confirmation dialog
- Group: adds favorite to a selected group
- Color: adds favorite with a preselected color
- Name: adds favorite with a given name prefix
Add track waypointAdds new Track waypoint to currently recording track.
- Show an interim dialog: displays confirmation dialog
- Group: adds favorite to a selected group
- Color: adds favorite with a preselected color
- Name: adds favorite with a given name prefix
Add map markerAdds marker to a selected (center) map location.
Add parking place
Plugin
Adds parking to a selected (center) map location. Old parking position is deleted.
Add POI
Plugin
Adds POI to a selected (center) map location map (same as context menu action).
- Show an interim dialog: displays confirmation dialog
- POI type (optional): preselect OSM type
- Tag/Value (multiple): add OpenStreetMap tags / values
Add OSM Note
Plugin
Adds OSM Note
- Show an interim dialog: displays confirmation dialog
- Message: adds default message to the note
Add media note
Android Plugin
Starts audio / photo / video note recording for a selected (center) map location.

Configure map

ActionDescription
Show/hide favoritesShow or hide the favourite points on the map.
Show/hide tracksShow or hide the last visible tracks on the map.
Show/hide POIEnable or disable POI layer with selected categories.
- POI Categories: allows to select multiple categories
Note: Action will replace previously selected categories, if POI layer was active before.
Show/hide public transportEnable or disable public transport map layer.
- Transport type (on first click): select one or many options from 'Transport stops', 'Bus, trolleybus, shuttle routes', 'Tram and train routes', 'Subway routes'
Change map sourceCreate a list of map sources and cycle through them.
- Show an interim dialog: displays dialog with maps list
- Do not show an interim dialog: map sources will be changed by defined order.
- Displayed Name - 'Map source >'. '>' after the map name indicates what is current selected map source.
- Displayed Name - '> Next map source'. '>' before the map name indciates what is next selected map source if action is executed.
- Note: you could have 1 action to change source and select multiple map sources or many quick actions with 1 map source selected, so you could quickly select the map source just from quick aciton list.
Change map overlayCreate a list of map sources as map overlay and cycle through them.
Note: works similar to Change map source (see above)
Change map underlayCreate a list of map sources as map underlay and cycle through them.
Note: works similar to Change map source (see above)
Change map styleCreate a list of map styles for vector maps and cycle through them.
Note: works similar to Change map source (see above)
Show/hide Mapillary
Plugin
Display or hide Mapillary layer on the map
Show/Hide contour lines
Plugin
Display or hide contour lines on the map
Show/hide Terrain
Plugin
Display and hide terrain layer on the map
Show/hide OSM notes
Plugin
Allows to display on the map all OSM notes
ActionDescription
Switch day/night modeSwitche between day and night map modes
Voice on/offMute or unmute voice guidance during navigation
Directions fromMark a selected (center) map location as a point of departure
Set destinationAdd a selected (center) map location as a destination. Previous destination becomes last intermediate point.
Add first intermediateAdd a selected (center) map location as first intermediate point. Previous destination stays the same.
Replace destinationSet / Replace a selected (center) map location as a destination. Previous destination is deleted.
Delete nearest destination pointRemove next intermediate point, if present, otherwise removes destination and displays finish navigation dialog. Action is inactive if you don't have any destination.
Auto zoom map on/offEnable or disable map auto zoom during navigation
Start/stop navigationStart navigation (if there is a destination point present) or stop navigation
Pause/resume navigationPause / Resume navigation
Change app profileCreate a list of application profiles and cycle through them.
- Show an interim dialog: displays dialog with profiles list
- Do not show an interim dialog: profiles will be changed by defined order.
- Note: you could have 1 action with multiple profiles or many actions with 1 profile.

Configure screen

ActionDescription
Show/hide Coordinates widgetShow and hide coordinates widget

Did this doc help you?

Privacy policy

Help us make these docs great!

All OsmAnd docs are open source. See something that's wrong or unclear? Submit a pull request.

Make a contribution

Or, learn how to contribute.