# Knowledge Base

**URL:** https://forum.woosmap.com/c/kb/12.md

[Latest](https://forum.woosmap.com/latest.md) · [Categories](https://forum.woosmap.com/categories.md) · [Tags](https://forum.woosmap.com/tags.md)

---

## [About the Knowledge Base category](https://forum.woosmap.com/t/about-the-knowledge-base-category/34)

<div class="topic-metadata">

**Author:** [@gael](https://forum.woosmap.com/u/gael)\
**Replies:** 0

</div>

The Knowledge Base category is used to share knowledge, tips and correct answers to common questions.

---

## [What is Woosmap's service level agreement (SLA)?](https://forum.woosmap.com/t/what-is-woosmaps-service-level-agreement-sla/49)

<div class="topic-metadata">

**Author:** [@gael](https://forum.woosmap.com/u/gael)\
**Replies:** 0\
**Last updated:** [March 4, 2021, 2:31pm UTC](https://forum.woosmap.com/t/what-is-woosmaps-service-level-agreement-sla/49 "2021-03-04T14:31:44Z")

</div>

Our service level commitment, and the figures we report against it, are described in our SLA.

---

## [Why am I seeing Cloudflare cookies on my website upon implementing Woosmap APIs?](https://forum.woosmap.com/t/why-am-i-seeing-cloudflare-cookies-on-my-website-upon-implementing-woosmap-apis/39)

<div class="topic-metadata">

**Author:** [@gael](https://forum.woosmap.com/u/gael)\
**Replies:** 0\
**Last updated:** [March 4, 2021, 2:22pm UTC](https://forum.woosmap.com/t/why-am-i-seeing-cloudflare-cookies-on-my-website-upon-implementing-woosmap-apis/39 "2021-03-04T14:22:20Z")

</div>

Cloudflare is a website security company which provides a CDN (Content delivery network) and DNS (Domain name server) along with other security products, including DDoS mitigation. Woosmap APIs rely on Cloudflare to serv…

---

## [Why should I secure my API keys?](https://forum.woosmap.com/t/why-should-i-secure-my-api-keys/62)

<div class="topic-metadata">

**Author:** [@gael](https://forum.woosmap.com/u/gael)\
**Replies:** 0\
**Last updated:** [March 4, 2021, 2:48pm UTC](https://forum.woosmap.com/t/why-should-i-secure-my-api-keys/62 "2021-03-04T14:48:58Z")

</div>

Properly maintaining the security level of your API keys ensures that they will be consumed by you and you only, on specific projects/organizations. To learn more about why you should secure your API keys, please visit t…

---

## [What is a public API key?](https://forum.woosmap.com/t/what-is-a-public-api-key/60)

<div class="topic-metadata">

**Author:** [@gael](https://forum.woosmap.com/u/gael)\
**Replies:** 0\
**Last updated:** [March 4, 2021, 2:46pm UTC](https://forum.woosmap.com/t/what-is-a-public-api-key/60 "2021-03-04T14:46:54Z")

</div>

A public API key, is an application programming interface unique key that allows the owner of a network-accessible service to give access to consumers of that service. It only has reading rights and should be used client…

---

## [What is a private API key?](https://forum.woosmap.com/t/what-is-a-private-api-key/61)

<div class="topic-metadata">

**Author:** [@gael](https://forum.woosmap.com/u/gael)\
**Replies:** 0\
**Last updated:** [March 4, 2021, 2:48pm UTC](https://forum.woosmap.com/t/what-is-a-private-api-key/61 "2021-03-04T14:48:07Z")

</div>

A private key allows you to manage your project related data. It has both reading and writing rights. It can not be used client-side. It is usually used for server-server interactions.

---

## [How to manage Teams in Woosmap Console?](https://forum.woosmap.com/t/how-to-manage-teams-in-woosmap-console/57)

<div class="topic-metadata">

**Author:** [@gael](https://forum.woosmap.com/u/gael)\
**Replies:** 0\
**Last updated:** [March 4, 2021, 2:45pm UTC](https://forum.woosmap.com/t/how-to-manage-teams-in-woosmap-console/57 "2021-03-04T14:45:17Z")

</div>

Teams allow you to create specific groups of members with specific rights over one or more projects. A member can be added to as many Teams as you wish, but you have a full flexibility to do things like grating access o…

---

## [I want to stop using Woosmap, how can I can cancel my Enterprise subscription?](https://forum.woosmap.com/t/i-want-to-stop-using-woosmap-how-can-i-can-cancel-my-enterprise-subscription/69)

<div class="topic-metadata">

**Author:** [@gael](https://forum.woosmap.com/u/gael)\
**Replies:** 0\
**Last updated:** [March 4, 2021, 3:02pm UTC](https://forum.woosmap.com/t/i-want-to-stop-using-woosmap-how-can-i-can-cancel-my-enterprise-subscription/69 "2021-03-04T15:02:05Z")

</div>

To cancel your enterprise subscription, please get in touch with your sales account manager.

---

## [I have setup my API request correctly, with my own public API key, yet I receive an error saying I do not have permission to perform this action, why?](https://forum.woosmap.com/t/i-have-setup-my-api-request-correctly-with-my-own-public-api-key-yet-i-receive-an-error-saying-i-do-not-have-permission-to-perform-this-action-why/68)

<div class="topic-metadata">

**Author:** [@gael](https://forum.woosmap.com/u/gael)\
**Replies:** 0\
**Last updated:** [March 4, 2021, 2:58pm UTC](https://forum.woosmap.com/t/i-have-setup-my-api-request-correctly-with-my-own-public-api-key-yet-i-receive-an-error-saying-i-do-not-have-permission-to-perform-this-action-why/68 "2021-03-04T14:58:50Z")

</div>

Please verify your authorized domains and project are consistent with your API requests. If not, just add a new domain or make sure you integration handles referrers properly.

---

## [I have a problem with locations returned by the Localities API, who can help me?](https://forum.woosmap.com/t/i-have-a-problem-with-locations-returned-by-the-localities-api-who-can-help-me/67)

<div class="topic-metadata">

**Author:** [@gael](https://forum.woosmap.com/u/gael)\
**Replies:** 0\
**Last updated:** [March 4, 2021, 2:57pm UTC](https://forum.woosmap.com/t/i-have-a-problem-with-locations-returned-by-the-localities-api-who-can-help-me/67 "2021-03-04T14:57:36Z")

</div>

Our support team will certainly be able to assist you with the deployment of Localities API. Please connect using this forum or via the Contact Us form here.

---

## [I have enough queries to properly try out Woosmap if I sign up for a trial?](https://forum.woosmap.com/t/i-have-enough-queries-to-properly-try-out-woosmap-if-i-sign-up-for-a-trial/66)

<div class="topic-metadata">

**Author:** [@gael](https://forum.woosmap.com/u/gael)\
**Replies:** 0\
**Last updated:** [March 4, 2021, 2:56pm UTC](https://forum.woosmap.com/t/i-have-enough-queries-to-properly-try-out-woosmap-if-i-sign-up-for-a-trial/66 "2021-03-04T14:56:25Z")

</div>

Yes, you have plenty of credits to try and use Woosmap. If you overpass a reasonable use, as described in our pricing policy, you will be contacted by our Sales team. Please refer to our pricing plan for more details abo…

---

## [How do I start a trial?](https://forum.woosmap.com/t/how-do-i-start-a-trial/65)

<div class="topic-metadata">

**Author:** [@gael](https://forum.woosmap.com/u/gael)\
**Replies:** 0\
**Last updated:** [March 4, 2021, 2:55pm UTC](https://forum.woosmap.com/t/how-do-i-start-a-trial/65 "2021-03-04T14:55:10Z")

</div>

To start a trial, you must first sign up to Woosmap by creating an account and your organization. Once in, you can complete the tutorial to learn how the console works. Every APIs are available in your trial account.

---

## [Can I have multiple projects and organizations?](https://forum.woosmap.com/t/can-i-have-multiple-projects-and-organizations/64)

<div class="topic-metadata">

**Author:** [@gael](https://forum.woosmap.com/u/gael)\
**Replies:** 0\
**Last updated:** [March 4, 2021, 2:52pm UTC](https://forum.woosmap.com/t/can-i-have-multiple-projects-and-organizations/64 "2021-03-04T14:52:29Z")

</div>

You can create as many projects as you want within your organization but there should only be one organization per company. When using Woosmap in production environment, API keys must be organized under one single organ…

---

## [How can I monitor my usage of Woosmap APIs?](https://forum.woosmap.com/t/how-can-i-monitor-my-usage-of-woosmap-apis/63)

<div class="topic-metadata">

**Author:** [@gael](https://forum.woosmap.com/u/gael)\
**Replies:** 0\
**Last updated:** [March 4, 2021, 2:51pm UTC](https://forum.woosmap.com/t/how-can-i-monitor-my-usage-of-woosmap-apis/63 "2021-03-04T14:51:25Z")

</div>

Within each projects of your organization is a dedicated metrics section that allows you to monitor your usage of every Woosmap API.

---

## [What is a project?](https://forum.woosmap.com/t/what-is-a-project/59)

<div class="topic-metadata">

**Author:** [@gael](https://forum.woosmap.com/u/gael)\
**Replies:** 0\
**Last updated:** [March 4, 2021, 2:46pm UTC](https://forum.woosmap.com/t/what-is-a-project/59 "2021-03-04T14:46:33Z")

</div>

A project is a container for your locations (assets) and where you manage your API keys. It’s also a way for you to segment your consumptions per criteria (e.g. : 1 project per country, 1 project per use case).

---

## [What is an Organization?](https://forum.woosmap.com/t/what-is-an-organization/58)

<div class="topic-metadata">

**Author:** [@gael](https://forum.woosmap.com/u/gael)\
**Replies:** 0\
**Last updated:** [March 4, 2021, 2:46pm UTC](https://forum.woosmap.com/t/what-is-an-organization/58 "2021-03-04T14:46:09Z")

</div>

An Organization allows a group of users to collaborate on the Woosmap console. It’s somehow your company’s folder on the Woosmap servers. It is private, and only your members can access it. It’s also where we handle yo…

---

## [How many users can access my organization?](https://forum.woosmap.com/t/how-many-users-can-access-my-organization/56)

<div class="topic-metadata">

**Author:** [@gael](https://forum.woosmap.com/u/gael)\
**Replies:** 0\
**Last updated:** [March 4, 2021, 2:43pm UTC](https://forum.woosmap.com/t/how-many-users-can-access-my-organization/56 "2021-03-04T14:43:49Z")

</div>

As many as you want to. The number of users is not limited, but given the strategic importance of your API keys, we highly suggest you restrict the access only to concerned users.

---

## [Can I add a new user in my organization?](https://forum.woosmap.com/t/can-i-add-a-new-user-in-my-organization/55)

<div class="topic-metadata">

**Author:** [@gael](https://forum.woosmap.com/u/gael)\
**Replies:** 0\
**Last updated:** [March 4, 2021, 2:43pm UTC](https://forum.woosmap.com/t/can-i-add-a-new-user-in-my-organization/55 "2021-03-04T14:43:22Z")

</div>

Yes you can. To do so, just access the “Members” tab in the left section of the console and then click on “Invitations” in the upper right corner. If you have divided your organization in Teams (often use to segment mar…

---

## [Are there different types of accounts in the Woosmap Console?](https://forum.woosmap.com/t/are-there-different-types-of-accounts-in-the-woosmap-console/54)

<div class="topic-metadata">

**Author:** [@gael](https://forum.woosmap.com/u/gael)\
**Replies:** 0\
**Last updated:** [March 4, 2021, 2:42pm UTC](https://forum.woosmap.com/t/are-there-different-types-of-accounts-in-the-woosmap-console/54 "2021-03-04T14:42:13Z")

</div>

Yes, there are three types of accounts in the Woosmap console: owner co-owner regular user The difference between them is that there is only one owner. He can change the properties of the organization and manage priva…

---

## [How does the billing work?](https://forum.woosmap.com/t/how-does-the-billing-work/53)

<div class="topic-metadata">

**Author:** [@gael](https://forum.woosmap.com/u/gael)\
**Replies:** 0\
**Last updated:** [March 4, 2021, 2:34pm UTC](https://forum.woosmap.com/t/how-does-the-billing-work/53 "2021-03-04T14:34:10Z")

</div>

Each time you request the Woosmap APIs, a credit is deducted depending on the type of request (see credit explanation here). Woosmap is billed by purchasing an annual license with a bucket of credits that can be used ac…

---

## [Which browsers does Woosmap support?](https://forum.woosmap.com/t/which-browsers-does-woosmap-support/37)

<div class="topic-metadata">

**Author:** [@gael](https://forum.woosmap.com/u/gael)\
**Replies:** 0\
**Last updated:** [March 4, 2021, 2:20pm UTC](https://forum.woosmap.com/t/which-browsers-does-woosmap-support/37 "2021-03-04T14:20:26Z")

</div>

We support current versions of the major browsers: Edge, Firefox, Chrome and Safari. Internet Explorer is no longer supported.

---

## [Is Woosmap hosted, or do I have to host it?](https://forum.woosmap.com/t/is-woosmap-hosted-or-do-i-have-to-host-it/38)

<div class="topic-metadata">

**Author:** [@gael](https://forum.woosmap.com/u/gael)\
**Replies:** 0\
**Last updated:** [March 4, 2021, 2:20pm UTC](https://forum.woosmap.com/t/is-woosmap-hosted-or-do-i-have-to-host-it/38 "2021-03-04T14:20:42Z")

</div>

Woosmap is fully hosted, meaning you do not have to set up your own servers. As soon as you sign up, you can start using the locator immediately, totally hassle-free.

---

## [Can I automatically retrieve my visitor's location to show them which is the closest store?](https://forum.woosmap.com/t/can-i-automatically-retrieve-my-visitors-location-to-show-them-which-is-the-closest-store/41)

<div class="topic-metadata">

**Author:** [@gael](https://forum.woosmap.com/u/gael)\
**Replies:** 0\
**Last updated:** [March 4, 2021, 2:23pm UTC](https://forum.woosmap.com/t/can-i-automatically-retrieve-my-visitors-location-to-show-them-which-is-the-closest-store/41 "2021-03-04T14:23:21Z")

</div>

Automatically detecting a visitor’s position allows you to personalize your customer journeys. For this purpose, we have developed the Woosmap Geolocation API. Please visit the product page to learn more.

---

## [Does Woosmap work with my CMS?](https://forum.woosmap.com/t/does-woosmap-work-with-my-cms/42)

<div class="topic-metadata">

**Author:** [@gael](https://forum.woosmap.com/u/gael)\
**Replies:** 0\
**Last updated:** [March 4, 2021, 2:24pm UTC](https://forum.woosmap.com/t/does-woosmap-work-with-my-cms/42 "2021-03-04T14:24:06Z")

</div>

Woosmap should work with any system. You can simply embed our Store Locator Widget interface into your page or build your own using our APIs. The setup is typically easy.

---

## [Which API do I need?](https://forum.woosmap.com/t/which-api-do-i-need/43)

<div class="topic-metadata">

**Author:** [@gael](https://forum.woosmap.com/u/gael)\
**Replies:** 0\
**Last updated:** [March 4, 2021, 2:24pm UTC](https://forum.woosmap.com/t/which-api-do-i-need/43 "2021-03-04T14:24:18Z")

</div>

Depending on your projects, you might need to use one or several of our APIs. Please visit woosmap.com to see how we can help you and your use cases.

---

## [Do I have to host my data on Woosmap?](https://forum.woosmap.com/t/do-i-have-to-host-my-data-on-woosmap/44)

<div class="topic-metadata">

**Author:** [@gael](https://forum.woosmap.com/u/gael)\
**Replies:** 0\
**Last updated:** [March 4, 2021, 2:25pm UTC](https://forum.woosmap.com/t/do-i-have-to-host-my-data-on-woosmap/44 "2021-03-04T14:25:06Z")

</div>

Yes and no, it depends on the API and use case your are implementing. For instance, if you are using our Store Locator to help users visualize the closest store on a map, you must indeed load your stores list onto the W…

---

## [Can I customize my Store Locator?](https://forum.woosmap.com/t/can-i-customize-my-store-locator/45)

<div class="topic-metadata">

**Author:** [@gael](https://forum.woosmap.com/u/gael)\
**Replies:** 0\
**Last updated:** [March 4, 2021, 2:26pm UTC](https://forum.woosmap.com/t/can-i-customize-my-store-locator/45 "2021-03-04T14:26:12Z")

</div>

Absolutely, there are a wide range of personalization that you can find in the documentation here. Depending on your need, you might want to choose our ready-to-use Store Locator Widget or build your own with the Map JS…

---

## [I have a lot of Locations, can I import them all?](https://forum.woosmap.com/t/i-have-a-lot-of-locations-can-i-import-them-all/40)

<div class="topic-metadata">

**Author:** [@gael](https://forum.woosmap.com/u/gael)\
**Replies:** 0\
**Last updated:** [March 4, 2021, 2:22pm UTC](https://forum.woosmap.com/t/i-have-a-lot-of-locations-can-i-import-them-all/40 "2021-03-04T14:22:35Z")

</div>

Yes, you can import all of your locations with our importer API in either Excel or CSV file formats. Alternatively, if you’re unsure about importing your locations, you can send us your file and we’ll import it for you. …

---

## [Does your Store Locator work on Mobile?](https://forum.woosmap.com/t/does-your-store-locator-work-on-mobile/36)

<div class="topic-metadata">

**Author:** [@gael](https://forum.woosmap.com/u/gael)\
**Replies:** 0\
**Last updated:** [March 4, 2021, 2:20pm UTC](https://forum.woosmap.com/t/does-your-store-locator-work-on-mobile/36 "2021-03-04T14:20:10Z")

</div>

Yes. The locator is fully responsive and works on mobile and tablet devices, as well as a regular desktop browser. Furthermore, the locator takes advantage of available mobile features - like providing accurate geolocati…

---

## [What is Localities API?](https://forum.woosmap.com/t/what-is-localities-api/46)

<div class="topic-metadata">

**Author:** [@gael](https://forum.woosmap.com/u/gael)\
**Replies:** 0\
**Last updated:** [March 4, 2021, 2:29pm UTC](https://forum.woosmap.com/t/what-is-localities-api/46 "2021-03-04T14:29:52Z")

</div>

Localities is a RESTful API that enables developers to retrieve location related suggestions based on an input string typed in a search bar. Basically it allows end user to receive on-the-fly predictions on city names, …

[Next page](https://forum.woosmap.com/c/kb/12.md?page=1)
