How do I change the WiFi settings on a Pearl device?

Learn how to easily adjust WiFi settings on your Pearl device for connectivity issues.

Table of Contents

    To change the WiFi network on a Pearl device, open the device detail screen in the Storetraffic app and tap Configure WiFi. This is used when your store changes its network name or password, or when you are moving a Pearl to a new location.

    Before You Start

    • Have your store's 2.4GHz WiFi network name (SSID) and password ready.
    • WiFi configuration applies to Pearl devices only — 3DScope cameras are wired and do not have a WiFi configuration option.
    • Requires write access. Read-only accounts do not see the Configure WiFi action.
    • WiFi and Location permissions must be enabled on your phone. On Android 13+, Nearby WiFi Devices permission is also required.

    Steps

    1. Open the Storetraffic app and navigate to the location where the Pearl is installed.
    2. Tap the edit pencil icon to on the location open the menu.
    3. Select Devices list
    4. Tap the edit pencil icon on the Pearl device row.
    5. On the Device detail screen, tap Configure WiFi.
    6. Activate Setup Mode > Next
    7. Tap Select a WiFi network — a picker opens with two tabs:
    WiFi configuration screen

    Scan tab — the app scans for nearby networks. Tap your network name to select it.

    WiFi picker scan tab

    Manual tab — type the network name directly. Use this for hidden networks or if your network does not appear in the scan list.

    WiFi picker manual tab
    WiFi picker manual SSID entered

    Hidden network: if your network is hidden, it appears as a (hidden SSID) row in the scan list. Tap it to jump to the Manual tab and type the exact name.

    Hidden SSID in scan list
    1. Enter the WiFi password.
    2. Tap Connect Device. The app sends the new settings to the Pearl — this takes about a minute.
    3. On success, the app returns to the device list. The Pearl will begin reporting on its next scheduled interval.

    Notes

    • Pearl only supports 2.4GHz networks. It will not connect to 5GHz-only, WPA3-only, Enterprise, or captive-portal (login page) networks.
    • The SSID and password are case-sensitive. Double-check for typos if the connection fails.
    • The WiFi network the Pearl joins does not need to be the same network your phone is on.
    • On iPhone, the app cannot open your phone's WiFi settings for you — if you need to switch your phone's network, do it from Control Center first, then return to the app.
    • If the Pearl does not connect, verify the phone can reach the same network with 3 bars or stronger (-79dBm or better), then retry.
    • After a successful reconfiguration, allow up to 2 hours for the Pearl to fully sync and appear as healthy.
    • How do I set up a Pearl device in the Storetraffic app?
    • Why is my Pearl device showing as offline or not reporting?
    • How do I rename a device in the Storetraffic app?
    • What WiFi networks are compatible with the Pearl people counter?
    header-top-left-border Created with Sketch.
    header-top-right-border Created with Sketch.