OpenStreetMap for Jira

Every Jira issue can have a location attached. The OpenStreetMap Issue Panel lets you add map context to individual tasks, bugs, or stories.

To use the issue panel:

1. Open any Jira issue.
2. Locate the "OpenStreetMap Location" panel (usually on the right sidebar or below the description).
3. Set Location: Use the search bar to find a place, or click on the map to set the location.
4. Customize Details: You can change the location name and select your preferred map layer.
5. Layer Selection: Note that some layer types require an API key to be configured in Settings.

Visualize project locations directly on your Jira dashboards. The "OpenStreetMap Locations" gadget allows you to pin a map view to your daily workflow.

• Add Gadget: Click "Add gadget" on your dashboard and search for "OpenStreetMap Locations".
• Configure View: Set your default zoom level and center coordinates.
• Save: The gadget will retain your settings for all viewers of the dashboard.

Get a high-level view of your project's geography. The Project View adds a dedicated "OpenStreetMap" item to your project sidebar.

This view is ideal for keeping a persistent map reference for the entire project team, independent of specific issues or personal dashboards.

Administrators can configure app-wide settings to enhance the mapping experience for all users.

Default Map View

Set a global default view for new maps. This ensures that when users add a map to an issue or project, it starts focused on a relevant location (e.g. your main project site).

Global Default Map Settings

Map Tile Keys

Configure API keys for alternative tile providers to ensure reliable access to premium map styles.

API Key Configuration

You can add your own API keys for providers like MapTiler. This allows you to use their specialized map layers across all your projects without hitting usage limits.

Is my data secure?

Yes. Location data is stored within your Jira instance properties. We do not transmit your issue data to external servers.

Can I add multiple locations per embed?

Not yet but we plan to add this. Let us know at [email protected] if this is something you'd like to have.

I'd like to see feature xyz...

Please let us know at [email protected]! We'll look at adding features customers would like to see.

Need Help?

You can contact us at [email protected].