How can I use geofencing to send push notifications to users based on their location?

A geo campaign sends a push notification, fires a custom event, or both automatically when a user's device enters a location you defined on a map, such as a store, a venue, or a transit hub.

Before you start: your app needs the Pushwoosh SDK with location tracking enabled, and the user must grant location permission (background location on Android 10 and later). Geo-based messaging isn't available on HMS (Huawei) devices.

Create a geozone: go to Campaigns → Geo campaigns and click Create geozone.

1. Enter a Campaign name (up to 64 characters).
2. In Entry actions, turn on any combination of Send push, Fire event (default PW_GeozoneEntered, use it to start a journey), Fire exit event (PW_GeozoneExited), Fire dwell event (PW_GeozoneDwell, after 1–1440 minutes inside), and Assume exit after silence (PW_GeozoneExitedByTimeout). Keep at least one on.
3. With Send push on, choose Write a message (up to 1024 characters) or Use an existing preset.
4. Set the trigger location: Circle (range 50 m to 100 km, default 200 m) or Polygon (3 to 100 corners, for example a mall or venue outline).
5. Choose the Cooldown: Standalone (1 minute to 41 days), or a cluster whose cooldown overrides the geozone's own.
6. Set the Campaign schedule and click Save. The geozone is enabled immediately.

The exit event fires only when the device next reports its location to Pushwoosh, which can be seconds to hours after the actual exit.

Many locations: on the Geo campaigns page, click Import CSV to create geozones from a spreadsheet with Name, Latitude, and Longitude columns. Click Check without importing to validate the file first.

Learn more: Create a geozone