Woosmap Console

Get started with the 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
  10. Multi-Factor Authentication

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.

Sign Up Woosmap

Otherwise, if you’ve already created an account or accepted an invitation from your Organisation owner, just log 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 are 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 the Invitations button located at the upper right side of the dashboard.

Invite User Woosmap

An email invitation is valid for 7 days. If your teammates forgot to sign up through the invitation email, don’t worry, you can send another invitation.

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. It is not possible to change a projects from an organization to another.


By default, the person who creates the organization becomes the Owner. Only Owners and Co-Owners can create or administrate Teams. Teams allow to separate visibility rights over Projects.

Warning: only active users of Woosmap can be assigned to Teams.

Teams are useful to separate teammates depending on the Projects they are working on. Clients mostly use them to define Projects by markets (eg: Northern Europe, Eastern Europe, France..). See an example below:

Woosmap Console Teams View

A Team is composed of Members, who can have specific rights over one or more Projects

Woosmap Console Team Overview

In a Team, members have the same rights over specific projects. There are 3 rights levels:

Woosmap Console Team Projects Rights

Nota: one member can be part of multiple teams. An invited member will have access to no projects upon joining the Organization. An owner or co-owner must assign him to the expected Team(s) he should be part of.

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)

Multi-Factor Authentication

The Multi-factor Authentication is an authentication method that requires you to provide several verification factors to access your account. It is an easy way to strengthen your account security and prevent any authentication problems.

In the Woosmap Console, the Multi-factor Authentication requires you to link your mobile device to your Woosmap account and use a tokens system to access the console. You can use apps such as Google Authenticator or Microsoft Authenticator, available on both the Play Store and the Apple Store.

You can able the multi-factor authentication in just a few steps:

  1. Go to “My Profile” (bottom-left hand corner)
  2. Click on “Multi-Factor Authentication”
  3. Enter your password
  4. Click on “Add Mobile Device” button
  5. Enter a device name
  6. Scan the QR code with your multi-factor authentication app on your phone and enter the two tokens it shows you qr code scan and confirmation tokens

  7. Copy and save your recovery tokens in a place you’ll remember! six recovery tokens

Next time you’ll login to the Console, you’ll have to first enter your password and then the token generated by the app you’re using.

Related help articles

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