Woosmap Console

  1. Before You Begin
  2. Organization And Members
  3. Project Overview
  4. Dashboard
  5. Project Info
  6. Private keys
  7. Assets
  8. Widgets
  9. Woosmap Usage Reports
    1. Searches
    2. Recommendations
    3. Mapping
    4. Database

The Woosmap Console is a user-friendly dashboard that enables you to manage your assets and review your metrics. It’s the easiest way to upload your data and get your first experience with Woosmap.

Before You Begin

If you don’t already have a Woosmap account, follow our signup process at this page https://www.woosmap.com/en/sign_up/?utm_campaign=Woosmap%20Sign-up&utm_source=Developers-documentation.

Sign Up Woosmap

Otherwise, if you’ve already created an account or accepted an invitation from your owner organisation, sign in directly to the Woosmap Console.

After signing up, creating a local search experience is just three simple steps:

This three steps are described at the get started guide.

Organization And Members

Once your account is activated, if you’re the first user of your team to login, you’re invited to create an organization. An organization allows a group of users to collaborate together effectively, all while keeping your organization’s information private. After creating the organization, you can invite users to join in by specifying their email. Click on Members on the left side bar and INVITATIONS button.

Invite User Woosmap

Each invitation must be responded to within 7 days or it expires.

All your projects will belong to this organization so if the owner decides to remove a user, the projects he created will still be accessible.

Project Overview

Projects are containers for your assets and associated analytics usage. The first step before uploading your assets is to create a new Project specifying at least a name. For your first experience, we recommend you to begin with our integrated step-by-step guide by clicking the tutorial button on top of the Project listing page.

Woosmap Project Overview


When you login to Woosmap, the console displays a dashboard of counters for your projects, users and aggregated metrics.

Dashboard Woosmap Console

You are able to quickly refine your metrics for a specific project. Click on All Projects drop-down list to select the one you want. This page also enable you to navigate to your Project listing and Members listing by clicking the corresponding block.

Project Info

Click Projects on the left sidebar and select the one you want to manage.

Woosmap Project Info

This tab is an overview of your project representing the number of assets, your authorized domains and your Public Key. The Public Key is automatically generated when you add a new project to your organization. You could have only one Public Key per project. You can here authorize new domains name (allowed referrers - *.mydomain.com) where your assets will be displayed, recommended or searched.

Private keys

Private keys allow you to manage integrations on the server-side and perform creation of new and updates of existing assets. As we aggregate analytics usage per project, it is good form to create separate projects based on intended use, such as one for your staging environment and one for the production environment.


Click Assets tab when viewing a Project.

Woosmap Assets Overview

The page displays a table of your assets. As a prerequisite to manage them, you’ll need to create a Private Key. From your assets dashboard, you can:

Please note that to add or replace your assets using the console, the expected source data must be in native Woosmap JSON format.


Click Widgets tab when viewing a Project.

Woosmap Widgets Overview

Display your locations on top of a map through the Woosmap Store Locator Widget interface. Below the map, click on the block Integration code and copy/paste the Javascript snippet wherever you want to embed the Store Locator Widget, and enjoy Woosmap.

To match your preferences and website’s graphic style, several properties of your Store Locator Widget can be customised by the Woosmap team.

Woosmap Usage Reports

To view the Woosmap usage reports, click Metrics tab when viewing a Project.

The Woosmap usage reports provide real-time usage data for any APIs for which you use an API key, Private or Public. Note that the reports provide data from one hour and for up to 12 months.

Woosmap Project Overview

See below all the metrics you can retrieve. Click on each metrics to access corresponding fine-tuned indicators.


This counter represents the total number of times the search endpoint API was used using one of the following operations:


This counter represents the total number of times the Recommendation Javascript API was used, splitted in two categories.


Ten Mapping are counted when any of the following occur:

After a web page or application loads a map, any user interactions with it, such as panning, zooming, or switching map layers, do not generate additional Mapping count.


Count the use of internal data management operations. Please note that the increment is based on each asset and not on each call. For example a call to the endpoint api /replace giving it a json file of 100 assets will increment by 200 this counter (100 deleted and 100 created)

Related help articles

Was this article helpful?
Have more questions? Submit a request