WLOC Guides

Find the next step for the current WLOC setup

New users install the current Profile, start the WLOC connection, and confirm the result on the iPhone. A third-party VPN client is not required. Guides for those older clients are labeled legacy and are not the default path.

Download the iOS app Browse by task

Get started

Download WLOC and set up this iPhone.

Get WLOC from the App Store. The app walks you through a one-time configuration profile you can remove in Settings. Then run authorized tests from the app or any browser.

No third-party app
Install a system configuration profile
Turn on WLOC in iOS Settings
Control the test from the app or any browser

Restore, Revoke, and Emergency Stop stay available from the Portal. Confirm the result on the device, then Restore when the test is done.

WLOC

You can run this test from a browser

Cloud mode does not need a third-party VPN app, a jailbreak, or a computer. Sign in, register a device you own or are authorized to test, install a configuration profile, connect VPN, and run a diagnostic. Restore stays available.

How cloud mode works

Browse by task

Install the ProfileWhat the current Profile contains, and how to remove it.
Start the connectionTurn on the WLOC connection after the Profile is installed.
Restore the deviceStop a location test. This is not restoring a purchase, and it is not behind a paid plan.
Restore a purchaseFind an App Store purchase again. This does not restore the iPhone’s location.
SupportChoose the symptom, then the matching guide.
Compatibility statusOne blocked observation. Other builds stay unverified.

Current setup

Download WLOC from the App Store, install the one-time Profile, turn it on in Settings, and confirm the result on the iPhone.

iPhone Location Changer without jailbreak — what works for testing and what does notNeed to change your iPhone location without jailbreak? WLOC is an iPhone Location Changer built for authorized testing: reusable coordinates, setup links, diagnostics, and recovery. No jailbreak. No computer needed.
Fake GPS on iPhone without jailbreak — what actually works and what does notWant to change your iPhone GPS location without jailbreak? Understand what Fake GPS actually means, what WLOC can and cannot do, and how to test safely without risking your accounts.
Which location signal does WLOC test?See how the current WLOC testing Profile includes a certificate and a VPN tunnel and does not require a separate third-party VPN client. Diagnostics and a submitted Restore are not proof the target app adopted a location or that the iPhone is already restored.

Legacy client guide: Older client articles

This page describes an older WLOC setup that used a separate third-party network client. It is not the default path for a new user. The current app uses a testing Profile with a certificate and a VPN tunnel and does not require that client.

These articles describe a previous client. They are not the default path for a new user.

Which VPN apps does WLOC need—and why?Which VPN or network app does WLOC need? Compare compatible clients, Apple WPS principles, and iOS 26/27 troubleshooting for stale location and restoring real location.
Patched in the log, unchanged in the app? Check the evidence in orderIf an iPhone location changer looks unchanged on iOS 26 or later, check the client, HTTPS bridge, WLOC request, patch, app cache, permissions, and recovery in order.
A VPN icon, an IP region, network positioning, and GPS are four different signalsUnderstand VPN versus GPS location on iPhone: public IP, local Network Extension, Apple WPS network positioning, GPS hardware, permissions, cache, and app behavior.
Your proxy tool is not connectedWLOC diagnostics says your VPN or proxy is not connected. Learn what this means and how to fix it in 2 steps.
The WLOC module is not loadedWLOC diagnostics says the module is not installed or not reachable. Follow these steps to subscribe, import, and enable the WLOC module.
Can't connect to the device proxyWLOC diagnostics can't reach the device proxy. Check proxy status, module rules, and network configuration.
Device status can't be readWLOC diagnostics can reach the device but can't read status. Likely an outdated script — here's how to fix it.
Diagnostics passed, but the location still won't change?Patch count is above zero but a target app still shows an old or real location? Separate fresh-request evidence, app cache, permissions, GPS, and app-specific rules before choosing the next step.
Set up WLOC on Shadowrocket, step by step, with certificate trust explainedStep-by-step Shadowrocket WLOC configuration: import wloc.module, enable HTTPS Decryption, trust the CA certificate, scope to Apple WPS hosts, run diagnostics, and restore.
Get WLOC running on Surge 5 — module, certificate, and MitM, step by stepComplete Surge 5 WLOC configuration: subscribe to wloc.sgmodule, configure MitM hostnames, trust the CA certificate, scope to Apple WPS, run diagnostics, and restore.
Configure WLOC on Quantumult X — rewrite rules, MitM, and certificate trustQuantumult X WLOC step-by-step: import wloc.conf rewrite and MitM sections, refresh script resources, generate and trust the CA certificate, run diagnostics, and restore.
Set up WLOC on Loon — plugin, certificate path, and MitM, step by stepComplete Loon WLOC configuration: install wloc.lpx plugin, configure plug-in certificate path, enable MitM, trust the CA, run diagnostics, and restore.
Get WLOC running on Stash — YAML override, scripts, and MitM, the right wayComplete Stash WLOC configuration: subscribe to wloc.stoverride directly (not through Script Hub), enable scripts and MitM, trust the CA, run diagnostics, and restore.
Set up WLOC on Egern — Surge-format module, own CA, and MitM, step by stepComplete Egern WLOC configuration: import the Surge-format wloc.sgmodule, generate Egern's own CA (do not reuse another client's), enable MitM, trust the certificate, run diagnostics, and restore.

Locations, routes, and Restore

Save a test target, preview a route on the device, and submit Restore when you finish. A submitted Restore is not proof the iPhone is already back.

Can you prepare an iPhone location test without a computer?WLOC is not a jailbreak. The current testing Profile includes a certificate and a VPN tunnel, and it does not require a separate third-party VPN client. Saving a target, Gateway acceptance, or a submitted Restore does not mean the target app adopted the location or that the device is already restored. WLOC does not promise to override every app's permissions, cache, or anti-cheat checks.
Turn a shared map link into a reusable iPhone test coordinatePaste an Apple Maps, Google Maps, Amap, or Baidu link on iPhone, extract latitude and longitude, identify the source system, and normalize the target to WGS84.
Create and preview a route before you start playbackCreate a WLOC route with two or more points or a GPX track, preview distance and duration locally, then start playback with the current testing Profile. Stopping a route or submitting Restore is not proof the iPhone is already back.

Fix a failed diagnostic check

Find the first failed item in WLOC, then follow only the repair steps for that layer.

Turn on the WLOC service in SettingsWLOC service is off until this iPhone starts the service from the testing Profile. Open Settings, turn WLOC on, then return so the Gateway can rewrite location requests.

Developer and QA reference

Plan repeatable evidence for permissions, geofences, background behavior, accuracy, Xcode, and App Review.

Turn an Xcode GPX file into a route test you can explainBuild repeatable Xcode GPX route tests for an iPhone app, with purposeful waypoints, observable assertions, realistic motion, and a clean return to normal location.
Make XCUITest location simulation prove a user outcomeUse XCUILocation in XCUITest without stale state: set location before launch, control permissions and cache, assert the app result, and preserve useful failure evidence.
Test the permission journey, not only the Allow buttonTest iOS location permission states as product journeys: first request, denial, Settings changes, When In Use, Always, Precise Location, and useful fallbacks.
Test the behavior around a geofence edge, not a perfect lineTest iPhone geofence boundaries with inside and outside controls, ordered transitions, accuracy states, relaunch evidence, condition limits, and clean teardown.
Prove the background feature without treating the app as always runningTest iOS background location behavior across authorization, suspension, queued updates, relaunch, indicators, battery policy, route evidence, and recovery.
Test the quality of each iPhone location, not just its latitude and longitudeTest iPhone location freshness, horizontal accuracy, timestamps, ordering, and recovery without treating every coordinate change as a reliable result.
Audit a location changer before trusting it with coordinates, devices, or accountsEvaluate an iPhone fake GPS or location changer vendor by data flow, permissions, profiles, disclosures, retention, account access, and clean removal.
Detect simulated location on iOS without mistaking a signal for a verdictUse CLLocation source information defensively in an owned iOS app, understand its limits, preserve legitimate tests, and avoid false certainty.
Give App Review a deterministic way to reach every location-dependent featurePrepare a reliable App Review path for an iPhone location app with demo accounts, public fixtures, review notes, permissions, backend stability, and recovery.
Troubleshoot Pokémon GO GPS signal not found on iPhone with official checksTroubleshoot Pokémon GO GPS signal and location errors on iPhone using current Niantic and Apple guidance for permissions, connectivity, devices, and recovery.
“Mock location” is an Android control, not an iPhone settingMock location means something specific on Android. Learn how iPhone developer location testing differs, where Xcode and GPX fit, and what WLOC actually does.
Build a location test pyramid before reaching for a GPS changerA practical iPhone developer location testing stack from unit coordinates to device QA and recovery.
Test a GPS changer like an engineering dependency, not a magic switchEvaluate a GPS changer or location changer with a reproducible iPhone QA checklist covering scope, evidence, cache, boundaries, privacy, and recovery.
Pokémon GO GPS spoofing is an account-risk issue, not a setup tutorialNiantic treats Pokémon GO GPS spoofing as cheating. Read the current account-risk rules, what WLOC does not support, and safe options for players and developers.
Cover U.S. location behavior with a focused evidence matrixPlan United States location testing for iPhone apps across metro, suburb, service-area edge, state boundary, time zone, route, and recovery cases.

Region and eligibility research

Separate device location from account region, hardware, subscription, regulatory, and service eligibility.

ECG not showing on Apple Watch? Start with region, model, and ageApple Watch ECG app showing as unavailable? Check region support, Apple Watch model, age requirements, and device location conditions before troubleshooting.
Irregular rhythm notifications missing? Check region and model firstIrregular rhythm notifications not appearing? Check Apple Watch model compatibility, regional support list, age requirements, and device location conditions.
Fitness+ missing? The three things that actually gate accessFitness+ shows as unavailable? Check Apple ID country, Fitness+ region support list, device compatibility, and subscription requirements.
Before you switch App Store countries, know what you are giving upChanging your iPhone App Store country affects subscriptions, payment methods, and app availability. Understand all the downstream effects before switching.
Blood Oxygen not on your Apple Watch? It might be your countryBlood Oxygen app missing on Apple Watch? Check if your country is on Apple's support list, verify your Series 6+ model, and understand how region gating works.
Why your streaming library shrinks when you travelWhy Netflix, Disney+, and Spotify show different content in different countries. How streaming apps detect your region and what signals matter.
Cycle Tracking not available? The region-model-age triangleCycle Tracking missing from Health app? Check region support, Apple Watch model (Series 8/Ultra for temperature sensing), age, and device location.
Walking Steadiness notifications missing? Check your iPhone modelWalking Steadiness notifications not showing? Check iPhone model (iPhone 8+), region support, and Health app mobility data requirements.
Sleep apnea notifications not showing? Model first, then regionSleep apnea notifications not available? Check Apple Watch model (Series 9/Ultra 2), watchOS version, region support, and sleep tracking requirements.
Hypertension notifications require specific hardware, age, and regionHypertension notifications not appearing? Check Apple Watch model, age (22+), pregnancy status, region support, and blood pressure monitoring requirements.
Why your mobile game shows different content in different countriesMobile game content locked by region? How games use App Store country, device location, and IP to restrict content — and which signals you can verify.
Same iPhone, different content — why apps change by countrySame app, different content? How apps use device location, Apple ID region, and IP address to customize what you see by country on iPhone.
Why your banking app blocks you when you travelBanking app blocked abroad? Banks may look at device location, IP address, and SIM data. This page does not tell you to use WLOC to make a banking feature appear.
Fintech apps check more than your GPS — here is the full pictureFintech apps like Revolut and Wise unavailable or restricted? How KYC, licensing, and device location affect regional access to financial apps.

Find the next step for the current WLOC setup

Download WLOC and set up this iPhone.

Help us improve WLOC