Menu

Debug on iOS Devices and the iOS Simulator

Debug on either an iOS device directly or debug on an iOS simulator.

Apple provides an excellent developer experience for debugging on Mac OS X. However, it is not possible to remotely debug iOS devices on Windows.

If you need to debug an iOS device on Windows, follow the Debug on Legacy Android with the Stock Browser (and on Other Devices) guide instead.


1. Debugging on an iOS Device

As you test your mobile site, you observe issues on specific devices. If the issue occurs on an iOS device, use this guide to inspect the device.


A. Enable Safari Web Inspector on your iOS device

  1. Open the "Settings" app on your iOS device.

  2. Navigate to "Safari > Advanced".

  3. Turn on the "Web Inspector" toggle.

Enable Safari Web Inspector


B. Enable the Develop menu on your Mac

  1. On your Mac, open the Safari browser.

  2. In the Safari menu bar, navigate to the "Safari" menu.

  3. Select "Preferences…"

  4. In the Safari browser preferences, switch to the "Advanced" tab.

  5. In the "Advanced" tab, turn on the "Show Develop menu in menu bar" toggle.

Enable Safari Develop Menu


C. Connect your iOS device to your Mac with a USB cable.


D. Open the page for debugging

  1. On the iOS device connected to your Mac, open Safari.

  2. Go to http://preview.mobify.com to preview your bundle.

  3. Fill in the form fields with your site information.

  4. Click "Preview".

  5. Navigate to the page for debugging.

Preview Learn to Preview your Project or to Preview your Project on a Device.

Preview on Computer


E. Inspect the page

  1. On your Mac, open Safari.

  2. In the Safari menu bar, choose the "Develop" menu.

  3. Scroll to the menu option that has your iOS device name.

  4. Select the page for debugging.

Inspect Device


Use the Safari Web Inspector to remotely debug the page on your iOS device.


2. Debugging on an iOS Simulator

To debug issues on different versions of iOS, use iOS Simulator. Download older versions of iOS within iOS Simulator to debug older versions of the operating system.


A. Download XCode

  1. On your Mac, click on the App Store icon in your dock.

  2. Type “Xcode” in your search bar to find Xcode.

  3. Follow the installation instructions.


B. Install the iOS Simulator

  1. On your Mac, open Xcode.

  2. On the Xcode menu bar, select "Xcode".

  3. Navigate to the "Preferences" menu option.

  4. Click "Downloads".

  5. In the "Components" tab, select the iOS Simulator versions that you would like.

  6. Click “Install”.


C. Run the iOS Simulator

  1. On the Xcode menu bar, select "Xcode".

  2. Navigate to the "Open Developer Tool" menu option.

  3. Click "iOS Simulator".


D. Open the page for debugging

  1. In iOS Simulator, open Safari.

  2. Navigate to Mobify Preview at http://preview.mobify.com to preview your bundle.

  3. Fill in the form fields with your site information.

  4. Click "Preview".

Navigate to the page for debugging.

Preview Learn to Preview your Project or to Preview your Project on a Device.

Preview on Device


E. Inspect the page

  1. In the Safari on your Mac, on the Safari menu bar, choose the "Develop" menu.

  2. Scroll to the iOS Simulator option.

  3. Select the page for debugging.

Preview on Simulator


Use the Safari Web Inspector to debug the page in iOS Simulator.

Edit in GitHub