> For the complete documentation index, see [llms.txt](https://ursus-ecom.gitbook.io/arctos-theme/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ursus-ecom.gitbook.io/arctos-theme/blocks/links/google-map.md).

# Google map

Show a Google Map for your store location, a pickup point, or any address you want customers to find easily.

The **Google** **Map** block embeds an interactive Google Map directly into any section on your storefront. Use it to help customers find your physical store, a pickup or pop-up location, or any address relevant to your business.

### 1. What you can do

* Add a location by entering an address or pasting a Google Maps link
* Control the map's orientation and aspect ratio, with separate settings for mobile
* Choose between light and dark map themes, or switch to satellite view
* Set corner rounding and margin

### 2. How to add a Map block

You can add a **Google** **Map** block to any [custom section](/arctos-theme/section-templates/section.md) or any compatible block, with no limit on how many you use in a single section.

{% stepper %}
{% step %}
**Click the section**

In the Theme Editor (Customize), click the section where you want to add the map.
{% endstep %}

{% step %}
**Add a block**

Click **Add block**.
{% endstep %}

{% step %}
**Select Google Map**

Select **Google Map** from the block list.
{% endstep %}

{% step %}
**Enter the location**

Choose how you want to add the location, then enter the address or paste the link.
{% endstep %}

{% step %}
**Adjust the settings**

Control appearance and layout using the settings below.
{% endstep %}

{% step %}
**Save your changes**

Click **Save**.
{% endstep %}
{% endstepper %}

### 3. Block settings

These settings let you control the location source, layout, and visual styling of the map.

<details>

<summary>Google Maps link</summary>

<table><thead><tr><th width="95.36328125">Setting</th><th width="132.26953125">Options</th><th width="454.62890625">When to use</th></tr></thead><tbody><tr><td><strong>Add location by</strong></td><td><ul><li>Enter address</li><li>Paste Google Maps link</li></ul></td><td><ul><li><strong>Enter address</strong> for a simple, exact location without leaving the theme editor.</li><li><strong>Paste a Google Maps link</strong> for locations that are hard to pin down with an address alone, like a specific building entrance or a place without a formal street address.</li></ul></td></tr><tr><td><strong>Address</strong></td><td>Text field</td><td><p>Type the full address, including street, city, and postal code, for the most accurate map pin.</p><p><em>Available when <strong>Add location by</strong> is set to <strong>Enter address</strong></em></p></td></tr><tr><td><strong>Google Maps URL</strong></td><td>Text field</td><td><p>Open the location in Google Maps, click <strong>Share</strong>, and paste the copied link here.</p><p><em>Available when <strong>Add location by</strong> is set to <strong>Paste Google Maps link</strong></em></p></td></tr></tbody></table>

</details>

<details>

<summary>Layout</summary>

Controls the map's shape, size, and how it adapts on mobile.

<table><thead><tr><th width="115.234375">Setting</th><th width="150.00390625">Options</th><th width="417.515625">When to use</th></tr></thead><tbody><tr><td><strong>Orientation</strong></td><td><ul><li>Square</li><li>Landscape</li><li>Portrait</li></ul></td><td><ul><li><strong>Square</strong> crops to 1:1</li></ul><p><em>Choosing <strong>Portrait</strong> or <strong>Landscape</strong> will unlock a secondary Aspect ratio settings with specific options for that format:</em></p><ul><li><strong>Portrait</strong> crops to a vertical format (9:16, 4:5, 5:7, or 3:4)</li><li><strong>Landscape</strong> crops to a horizontal format (16:9, 4:3, 3:2, or 21:9)</li></ul></td></tr><tr><td><strong>Width</strong></td><td><ul><li>Fill</li><li>Custom</li></ul></td><td><ul><li><strong>Fill</strong> stretches the map to the full width of its container</li><li><strong>Custom</strong> lets you set an exact width in pixels or as a percentage.</li></ul></td></tr><tr><td><strong>Custom on mobile</strong></td><td><ul><li>On</li><li>Off</li></ul></td><td>Turn on if you want a different orientation, aspect ratio, and width on mobile than what's set for desktop.</td></tr></tbody></table>

</details>

<details>

<summary>Style</summary>

<table><thead><tr><th width="95.29296875">Setting</th><th width="149.0703125">Options</th><th width="438.42578125">When to use</th></tr></thead><tbody><tr><td><strong>Map theme</strong></td><td><ul><li>Light</li><li>Dark</li></ul></td><td><ul><li><strong>Light</strong> shows the map in Google's standard light color scheme.</li><li><strong>Dark</strong> shows the map in a dark color scheme; choose this to match a dark-themed section or page.</li></ul></td></tr><tr><td><strong>Map type</strong></td><td><ul><li>Default</li><li>Satellite</li></ul></td><td><ul><li><strong>Default</strong> shows a standard road map.</li><li><strong>Satellite</strong> shows an aerial photo view, useful for rural locations, large properties, or landmarks that are easier to recognize from above than by street layout.</li></ul></td></tr><tr><td><strong>Corner radius</strong></td><td><ul><li>Main corner</li><li>Small</li><li>Extra small</li><li>None</li><li>Custom</li></ul></td><td><p>Controls how rounded the corners of your map frame are.</p><ul><li><strong>Main corner</strong> matches the global corner radius set in your theme.</li><li><strong>Small</strong> and <strong>Extra small</strong> inherit from the <a href="/pages/MtcWsJuspkVnqjnkw5Ur#id-1.-global-style-main-corner">main corner</a> value and scale it down proportionally for a subtler effect.</li><li><strong>None</strong> removes rounding entirely for a sharp, full-bleed look.</li><li><strong>Custom</strong> lets you set a precise value to match a specific design.</li></ul></td></tr></tbody></table>

</details>

<details>

<summary>Spacing</summary>

<table><thead><tr><th width="102.04296875">Setting</th><th width="132.73828125">Options</th><th width="448.21875">When to use</th></tr></thead><tbody><tr><td><strong>Margin</strong></td><td>Custom value per side</td><td>Set spacing around the block to separate it from neighboring blocks.</td></tr><tr><td><strong>Custom on mobile</strong></td><td><ul><li>On</li><li>Off</li></ul></td><td>Set separate margin values for mobile.</td></tr></tbody></table>

</details>