# Map
{% hint style="danger" %} Theme retirement Ira is no longer available on the Shopify theme store. **Theme support and updates for current users will end after May 18, 2024**. [Learn more here](/ira/readme/theme-retirement.md).
{% endhint %}
Use the **Map** section to promote your brick-and-mortar retail stores. This section is designed specifically for your address information and store hours.
## **Set up section**
Add this section to any template (except Checkout) and use the drag-and-drop handles to re-order its position. You can add this section multiple times with different content and settings.
{% hint style="info" %}
Editing a template changes all pages that use that template. To edit specific pages, you can create and assign new templates or use metafields and dynamic sources.
{% endhint %}
STEPS
In your theme editor (**Customize**):
1. Select a **Template** to edit from the dropdown menu in the top bar.
2. Under **Template**, click **(+) Add section** and select **Map**.
3. Change the order of your sections by using the drag and drop handles **`⋮⋮`**
4. Click on the title block to change the **Heading** text for the section.
5. Click on the **Store info** block to add your address and opening hours.
## **Configure your map**
To add a Google Map, you will need to set up a Google Maps API Key.
STEPS
In your theme editor (**Customize**):
1. Click on the **Map** section to open the settings.
2. (*Optional*.) Add an **Image** for the map section.
> This image will display as a fallback image if the map does not load.
3. The next fields (**Map address**, **Google Maps API key**, and **Custom map JSON**) require some additional set up.
> To learn more, see: [Get a Google Maps API key](#get-a-google-maps-api-key)
4. Return to the list of sections to find your new Map section.
> Use the drag handles to rearrange the order of your sections:
5. Click **Save** in the top-right corner.
## **Get a Google Maps API key**
Here's what you need to do to get a Google Maps API key:
STEPS
1. Sign up for Google Maps Platform. ([Link](https://cloud.google.com/maps-platform/#get-started).)
2. Select the **Maps** product.
3. Create a project for your Shopify store.
4. Enter your billing information.
> Unless you get more than 500,000 views per month, you will not be charged for map API requests. They will all be paid for with the recurring $200 credit Google gives its Cloud Platform users each month.
After this process, you are granted a Google Maps API key, which you can copy into Ira's map section *Google Maps API Key* field:
The API key should be a large jumbled string of characters, like this: **`AIzaSyCuv0hqbs8Itd_UvRQ0gAkwe5OxkYw_q08`**.
We recommend that you restrict your API key so it can only be used on requests to your store's URL (like **`https://your-store.com`**). You can restrict to multiple URLs if you also want to add your **`https://your-store.myshopify.com`** address for testing purposes.
The following video shows you how to do this from the [Google Cloud Platform Google Maps dashboard](https://console.cloud.google.com/google/maps-apis/overview) here:
If you lost your API key, you can find it again (or regenerate it) from the Google Cloud Platform [API Credentials](https://console.cloud.google.com/apis/credentials) page.
## **Custom map JSON**
Using JavaScript Object Notation (JSON), a form of JavaScript code used to send structured information and configuration, you can change the look and feel of your map.
Using the [Google Maps Platform Styling Wizard](https://mapstyle.withgoogle.com/) website, you can choose different map themes or tweak map settings.
Check out the following video for more information:
Once you have copied the JSON to your clipboard, you can paste it into Ira's **Custom map JSON** setting.
## Settings reference
Click on the section to find the following settings:
| Setting | Description |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Heading | Enter heading text to display as a section title. |
| Store information | Add your store information, like your address and hours. |
| Image | Select or upload an image to be displayed. |
| Map address | Add a street address that Google Maps can use to find your store. |
| Google Maps API key | Add your Google Maps API key. You can generate one using the directions |
| Custom map JSON | You can paste JSON configuration in this field to change the look and feel of your map.
You can find some map presets using Google's Map styles.
|
| Map link text | Add link text for the map link generated by Google Maps. |
***
> **Related links**
>
> [Image with text](/ira/sections/theme-sections/image-with-text.md)\
> [Rich text section](/ira/sections/theme-sections/rich-text.md)
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://help.fluorescent.co/ira/sections/theme-sections/map.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.