There are exactly two ways to get a subscription into a client app: press the one-tap import button in your provider account on a device that already has the client installed, or copy the subscription URL and paste it into the client manually. Most "import failed" complaints come from mixing the two paths up — tapping the one-tap button on a computer with no client installed, or pasting a URL that a chat app has wrapped and truncated.
This guide walks the flow in order — one-tap first, manual second, then diagnosis — and applies to Clash Verge Rev, ClashX-family apps, Shadowrocket, Loon, Stash, and Surge. Interface labels shift between versions; the order of reasoning does not.
Two safety rules first
- Treat the subscription URL as a personal credential. The long token inside it is your access key. Never post it in group chats; if it leaks, reset it from your account center.
- Import only on your own devices. A subscription imported on a shared or public computer should be considered leaked and reset.
One-tap import: fastest, with one precondition
The one-tap button hands your subscription to the matching client through the operating system, and the client asks you to confirm the addition. The precondition: the client must already be installed on the device you are tapping from.
So: to set up Shadowrocket on your phone, open the account center in the phone browser and tap there. To set up Clash Verge Rev on a desktop, tap from that desktop's browser. Watch for the browser's "open this app?" prompt and allow it.
One-tap did nothing? Check three things in order
- Is the client installed on this device? Without it, the tap usually does nothing at all. Install the client first, then tap again.
- Did the browser block the hand-off? Some browsers silently block app redirects. Look for a blocked-popup indicator near the address bar, or retry in the system default browser.
- Is the client outdated? Old builds may not register the import handler. Update from the official channel, or fall back to manual import.
Manual import: the universal fallback
Manual import always works and looks nearly identical everywhere:
- Copy the full subscription URL from your account center. Avoid copying from chat history where line-wrapping or ellipsis may have mangled it; paste into a plain-text editor and confirm a single line starting with
https://. - Open the client's Profiles / Subscriptions / Configuration screen, choose "import from URL" or its equivalent, paste, and confirm.
- Trigger one manual subscription update and confirm the node list appears.
For Clash Verge Rev specifically, the official profile guide documents URL subscriptions plus QR, file, and clipboard imports — any one of them is fine.
Import entry points by client
| Client | Platform | Manual entry point | One-tap |
|---|---|---|---|
| Clash Verge Rev | Windows / macOS / Linux | Profiles → New → import from URL | Supported |
| Shadowrocket | iOS | Home → + → type Subscribe → paste URL | Supported |
| Loon / Stash | iOS | Config/Subscription screen → add → paste URL | Use in-app paste |
| Surge | iOS / macOS | Profiles → Download Profile from URL | Use in-app paste |
| ClashX family | macOS | Menu bar → Config → Remote config → Add | Supported |
Imported is not connected
After the node list appears there are still three steps: activate the imported profile, pick a working node, and enable the system proxy or enhanced mode as needed. Test an ordinary website first, then your target service. If Clash Verge Rev keeps failing to import or update, follow this layered troubleshooting checklist.
When to contact support
If both paths fail after you have confirmed the plan is active and tried another trusted network, send support the client name and version, operating system, exact error text, and time of failure. Never send the full subscription URL or any password.
Need a subscription to import? See SSRocket Global Access plans — after purchase the account center offers both one-tap import and a copyable subscription URL. AI Hub is a separate product, not a network subscription.
FAQ
Is one-tap import safe?
Yes. It hands the subscription to the client on your own device without any third party in between. Passing subscription URLs around in chat apps is the riskier habit.
Do I need to re-import on a new device?
Yes. The subscription belongs to your account, but client configuration belongs to the device. Install the client on the new device, then one-tap or paste again.
Can one subscription serve several devices?
Yes, across your own devices, subject to the connection allowance of your plan. Do not share it with others; reset the credential if it ever leaks.