Installation Guide

Follow a few simple steps to have Omnium Maps up and running on your Shopify store.

Install Omnium Maps to your Shopify store and activate your monthly subscription

Start by installing our app from the Shopify App Store.

After installation, you will need to accept recurring payments for $4.99 per month (with a 7-day free trial). All payments are processed by the Shopify Platform. We do not handle your payment information directly. If you uninstall the app during the trial period, you will not be charged.

Once the app is installed and the subscription is activated, you should see the app's dashboard:

Installation Guide - Pic 0

You're now ready to start setting up your maps!

Step 1: Create map(s) on pages of your store

Each map you create will always be linked to a page on your store.

You can create your first map by clicking "Create a new map" and selecting the page where you want to see your map:

Installation Guide - Pic 1aInstallation Guide - Pic 1b

You can now add locations to your map, adjust settings, and more.

Installation Guide - Pic 1c

Once your map is ready, don’t forget to click the "Save changes" button:

Installation Guide - Pic 1d

After saving, return to the dashboard to continue with the installation.

Step 2: Provide your Google Maps API key.

Our application uses Google Maps at its core, so you will need to provide your own Google Maps API key for map rendering.

We prepared a detailed article on "How to get the Google Maps API key?" for your convenience.

Important: There are two key requirements for your API key:

  • Under the "APIs & Services" → "Enabled API & Services" section, enable the following APIs:
    • Maps JavaScript API
    • Geocoding API
    • Places API
  • Under "Billing" add your credit card information. Don’t worry, Google provides $200 of free credit each month!

If these requirements aren't met, the message "This page can't load Google Maps correctly" may appear on your maps.

After entering your Google Maps API key, click "Save API Key" and proceed to the next step.

Installation Guide - Pic 2

Step 3: Enable "Omnium Maps Assets" in the "App Embeds" sections of your theme

"Omnium Maps Assets" are optimized scripts and styles that handle map rendering on your storefront pages.

You can automatically enable these assets by clicking the "Enable Omium Maps Assets for your theme" button.

Installation Guide - Pic 3a

After clicking "Enable Omium Maps Assets for your theme", the Shopify Theme Editor will open, and the assets will be activated.

Now, click the "Save" button to apply the changes to your theme:

Installation Guide - Pic 3b
Installation Guide - Pic 3cInstallation Guide - Pic 3d

If you switch to another theme, you will need to re-activate this block for the new theme.

Now proceed to the next step of the installation.

Step 4: Adjust the map placement (Optional)

We recommend keeping the default "Automatic" placement, as it works best for most themes.

Installation Guide - Pic 4a

If automatic placement doesn’t work, switch to one of the manual options (CSS or Liquid):

Installation Guide - Pic 4bInstallation Guide - Pic 4c

Check your map on the storefront

Note: It may take a minute or two for your changes (locations, settings, placement adjustments) to appear on your store.

Now, check how your map works on your storefront page. If everything is set up correctly, the map should appear.

If the map doesn't appear, contact our support team for assistance with app integration.

Thank you!