Help center/Getting started

How to import a subscription into Shadowrocket on iPhone and iPad

Install Shadowrocket, import a ShieldFlow subscription, refresh nodes, and fix invalid configuration URL errors.

Updated 2026-07-106 min read

This guide shows how to import a ShieldFlow subscription into Shadowrocket on iPhone or iPad, refresh the node list, and fix the most common import errors. App Store availability and pricing vary by region.

Before you start

A subscription URL is an account credential. Do not post it in public chats, screenshots, reviews, or support forums. Reset it from the account dashboard if it has been exposed.

Method 1: one-tap import

  1. On the ShieldFlow client setup page, select iOS and Shadowrocket.
  2. Tap the one-tap import button. Safari opens the ShieldFlow import bridge and then Shadowrocket.
  3. Approve the new subscription when Shadowrocket asks for confirmation.
  4. Return to the home screen and pull down once to refresh the node list.

Method 2: manual subscription URL

  1. Copy the V2Ray-compatible subscription URL from ShieldFlow.
  2. Open Shadowrocket, tap +, and choose Subscribe.
  3. Paste the URL, set the remark to ShieldFlow, and save.
  4. Pull down on the home screen to update the subscription.

Connect and verify

  1. Select a nearby node with stable latency.
  2. Enable the main switch and allow iOS to add a VPN configuration.
  3. Open a browser and confirm that normal HTTPS pages load.

Common problems

"Invalid configuration URL"

Copy the URL again from ShieldFlow and make sure no spaces or line breaks were added. If a QR scanner cannot open the app handoff, use the manual URL method.

The subscription imports but shows no nodes

Pull down to refresh. If the list is still empty, delete only the subscription entry, add the latest URL again, and confirm that your ShieldFlow plan is active.

The node list is old

Open the subscription details, enable automatic updates, and keep the source URL unchanged so node availability changes can reach the client.

Still need help?
Send a ticket to the support team
Contact support