Configuring Beacons in the Proximity Web Panel

Using the Proximity Web Panel, you can configure your Beacons.  This allows you to change information such as the Beacon identifiers (Proximity UUID, Major, Minor, Namespace ID, Instance ID), Transmission Power, Advertising interval, alias, etc.

If you want to configure your Gateway then please look at our guide How to setup up your Gateway.

You can also use the profiles to apply one of our preset profiles or your own custom configuration, to a single beacon, or to multiple beacons at once.

It's important to note that once new settings are created on your Web Panel, your Bluetooth Beacons will not be updated until they're synced using our management app (available for iOS and Android) or SDK, as described here:

Beacon properties

Click on Beacons on the panel header and then on Beacons List.


This will open the list view for all your Bluetooth Beacons. 


Configuring individual Beacons

Clicking on the device unique Id or on the edit link to the right of the Beacon row (marked below), you can set properties for individual Beacons.

If you want to edit multiple devices at once, please follow this tutorial instead.


In this view you can review the basic information of your beacon and also change the general settings, where some useful presets are available, like our recommended settings or the energy saver. Our you can simply use the values of your choice for the Interval and Tx Power. It is also possible to give your device an alias.


Here you can also change the profile of your device or enable them all to use Packet interleaving.

Pending configurations and updating physical Beacons

When you change Beacon configurations or apply new profiles to your Beacons, the new settings will be in a pending state until the Beacons comes into range of a device running our software.

In both the list view and single beacon view, you'll see an indicator if your changes are in a pending state.


Your new values will be displayed in red. Values currently active on the Beacon will be stricken through.

Canceling a pending configuration.

To cancel a pending configuration, in case you no longer need to apply it, you can delete it by clicking cancel config link available in the orange box near the top right corner of the settings view of the device (or devices) for which you created it.


Synchronizing changes to your Beacons

Once you create the configuration in the Web panel, you will see the following message:

"Some properties aren't synchronized with your device. Please update your device's settings with the Admin App" 

This means that you need to apply the changes to the physical beacon. To update your Beacons with your new configuration, you'll need to get in range of the Beacon with a device running our iOS or Android Admin App.

Read our articles for iOS and Android to get detailed information on how to synchronize the new configuration.

If you are looking to create configurations for multiple beacons, please follow this tutorial


- 2017-11-01 22:48:53 UTC
Was this article helpful?
2 out of 2 found this helpful


  • Avatar

    If you select iBeacon in the "Select Profile" does this mean that only Apple devices can see that beacon? Or will Android devices see it too? If not do you need to buy a second beacon, set it to Android, and have the same Major/Minor as the IBeacon?

  • Avatar

    Hi Edgar. Although iBeacon is an Apple standard and the newly launched Eddystone a Google one, we've been working with iBeacon on Android for as long as we've in operation. Depending on what you plan to develop, you could use either or both, totally up to you; our Beacons can be easily configured to work on either.

  • Avatar

    how I can send a file from the beacon to my phone , I would like to give it a try

  • Avatar

    Hi Sandra. Beacons don't do much other than advertise their presence to your device through the iBeacon or Eddystone standard, your application should translate this into a meaningful message or interaction over to the user. Why don't you try the Eddystone-URL, it's now supported by Chrome for Android, check out this article.

  • Avatar
    appu balasubramaniam

    How can I handle the ACTIONS in mobile side,I seen SHOWCASE APP in that you store the data inside the app,If I upload Image in KONTAKT ADMIN panel,how I receive it? I can't find any sample in your GitHub sample app.

  • Avatar

    Hi Appu. Communicating and retrieving data from our API using our Android and iOS SDK is detailed here:

    Edited by Martin
  • Avatar
    appu balasubramaniam

    Hi Martin thanks for the reply,I am getting "Unable to resolve host "": No address associated with hostname" in CloudCallback,Please find my code below

    .execute(new CloudCallback() {
    public void onSuccess(Actions response, CloudHeaders headers) {


    public void onError(CloudError error) {


  • Avatar

    Hi Appu. Please check you're able to reach our from your end, everything is working fine from ours.

  • Avatar
    appu balasubramaniam

    I can reach from browser but when I tried the above call back in android app ,I am getting error "failed to connect to (port 443) after 10000ms"

  • Avatar
    appu balasubramaniam

    In browser also I am getting access denied error

  • Avatar

    Hi Appu. Our API is only available through HTTPS, make sure your API key is correctly set by following the guides shared earlier.

  • Avatar
    appu balasubramaniam

    Can't get action,Using valid API Key.Can you update any sample for getting action.

  • Avatar

    Hi Appu. There's a section devoted to the Actions API endpoint in our Android SDK documentation. Here it is again, in case you missed, just make sure you scroll down a bit:
    KontaktCloud kontaktCloud = KontaktCloudFactory.create();
    Actions actions = kontaktCloud.actions().fetch()

    Check out our GitHub account if you need more sample code, or feel free to reach us at if you need more help.

This site uses cookies. By continuing to browse the site you are agreeing to our use of cookies. Review our cookies information for more details.