Shadowrocket Subscription Setup: Subscribe, Add Server, QR Code & Clipboard

Learn where to use Subscribe, Add Server, QR codes, and clipboard import in Shadowrocket, and how subscription URLs differ from single-server links.

At a glance

Identify the content before choosing an import method: use Subscribe for server subscriptions, Add Server for individual server details, and QR codes or the clipboard only to transfer links. Neither method replaces checking the link format. The steps use the Home, Config, and Settings screens on iPhone and iPad; Mac, Windows, Android, and Linux users can apply the same format and parameter checks, though button locations vary by platform. Get subscription links from your service provider.

1. Tell subscriptions, single-server links, and Config files apart

In Shadowrocket, a “subscription” usually means a remote URL that can be requested repeatedly to retrieve a server list. A single-server link carries the connection parameters for one server. Either can be copied or scanned into the app, but they’re saved differently: subscriptions provide an updatable list, while single-server links usually create standalone entries.

Keep server subscriptions separate from Config files. Config manages configuration files containing items such as rules and DNS settings. These files may include rule keywords such as DOMAIN-SUFFIX, IP-CIDR, GEOIP, and FINAL. An HTTPS URL isn’t necessarily a server subscription just because it starts with HTTPS.

Server subscription URL

Example
https://example.com/sub?token=xxxx
Where to get it
Get it from your service provider
What gets imported
A subscription group and its server list
How to update
Request the original subscription URL again

This example uses a fake value and cannot be used to connect. Treat tokens in real URLs as credentials.

Single-server link

Common prefixes
ss://、vmess://、vless://、trojan://
What it contains
Encoded parameters for one server entry
What gets imported
A standalone server entry in Home
How to make changes
Reimport it or edit the relevant fields

A prefix only indicates a protocol type. It does not confirm that the parameters are valid or that the link supports subscription updates.

If the copied content starts with configuration sections such as [General] or [Rule], treat it as a configuration file—not something to paste into a server address field. If you’re unsure, ask your service provider whether it’s a server subscription, a single-server link, or a complete Config file. That’s more effective than trying different import methods.

2. Subscribe: Check what you’re adding from Config or Home

When looking for “Subscribe” on the Config screen, first check whether you’re handling a remote configuration or a server subscription. Adding, downloading, or updating a remote Config file applies to configuration files. To add a server subscription that you can select from Home, go to Home → “+” in the top-right corner → Add Server → Type → Subscribe. Both types can update from a URL, but they are not interchangeable.

  1. Get the URL

    Get a Shadowrocket-compatible server subscription URL from your service provider. Copy the entire URL; don’t copy the provider’s login page, the title of an information page, or nearby button text.

  2. Choose a type

    Go to Home → “+” in the top-right corner → Add Server, then set Type to Subscribe. This creates a server subscription, not a Config rules file.

  3. Enter the URL

    Paste the complete URL into URL, add an easy-to-recognize name in Remarks, and save. Don’t remove query parameters after the question mark or change the capitalization of the token.

  4. Check the list

    Return to Home and wait for the subscription request to finish. To request it again, use the subscription update action or pull to refresh. Expand the relevant group and check that server entries appear—not just a new group name.

If a remote configuration file appears after import but no servers are added to Home, check whether you added the URL in Config. Conversely, adding a rules-file URL as a Subscribe server subscription may produce a format error or an empty list. Confirm that the expected item appears and contains the right data; seeing “Saved” alone isn’t enough.

Keep the URL unchanged

The ?, &, =, and percent-encoded characters in a subscription URL all have specific meanings. Don’t decode them manually, insert line breaks, or replace half-width characters with full-width ones. If the link has expired, get a new one from your service provider instead of guessing at the parameters.

3. Add Server: Enter individual server details manually

Add Server isn’t limited to adding subscriptions. It’s the entry point for creating records, and Type determines the form fields and what gets saved. Manual entry is appropriate only when you have the server address, port, credentials, and protocol-specific parameters. If you only have a subscription URL, don’t paste the whole URL into Address.

Manual entries usually don’t change when you refresh a subscription. If your service provider changes a port or credential, edit the entry or import it again. WireGuard also requires protocol-specific settings such as keys, interface addresses, and peer details; it doesn’t use the password form for other protocols. If any fields are missing, ask for the complete parameters instead of trying to connect with blank values.

4. QR codes and clipboard: The transfer method doesn’t change the link type

A QR code can contain a single-server link, a subscription URL, or even an ordinary webpage address. Scanning only reads its contents; the text inside the code determines what gets imported. The same applies to the clipboard: if you copy a webpage title or a block of instructions, the app can’t use it to reconstruct connection parameters.

QR code import: what to check

  1. Open the QR scanner from Home and allow camera access if prompted. Fit the entire QR code in the scan area without cropping its corners or the necessary border around it.
  2. After scanning, check the preview or new-entry form: is it a URL with the Subscribe type, or a single entry with a specific protocol and server address?
  3. Confirm the source and the type of content before saving. If the result is just an information webpage, don’t try to use its URL as a server address.

Clipboard import: what to check

  1. Use the copy-link option on the source page, or select the entire link. Don’t copy surrounding quotation marks, list numbers, or punctuation.
  2. Switch to Shadowrocket and follow the clipboard import prompt shown in the app. If the system asks whether to allow pasting, check the content and allow it for this action.
  3. If no prompt appears, add a server subscription manually: go to Home → “+” → Type → Subscribe → URL and paste the link. For a single-protocol link, use the clipboard import option provided in the app. Don’t paste it into Address as if it were a hostname.

Don’t send a real subscription URL to an online decoder for troubleshooting. Its credentials may allow access to your server list, so protect QR code screenshots the same way. After importing, replace the clipboard contents with harmless text to reduce the chance of pasting the link by mistake.

5. After importing: Test the entry, then choose Global Routing

An entry appearing in the list only means its data was parsed and saved; it doesn’t prove the server is reachable. Select the entry you want in Home, run Connectivity Test, then connect and visit a known working webpage. A latency result doesn’t confirm that DNS, TLS, and webpage requests are all working—check by browsing as well.

4 import methods
Subscribe, Add Server, QR code, clipboard
4 routing modes
Global Routing:Proxy / Direct / Config / Scene
2 ways to get the app
iPhone / iPad: $2.99 one-time purchase; Mac / Windows / Android / Linux: free

Global Routing determines how traffic is handled; it doesn’t determine whether a subscription was saved correctly. For everyday use, check the Config contents and use Config. For troubleshooting, switch briefly to Proxy to see whether the issue occurs only with rule-based routing. Scene applies routing behavior based on its configured conditions. If you’re unfamiliar with those conditions, avoid adding another variable while troubleshooting.

Config

Recommended

Routes connections according to the rules in the selected Config. A match may send traffic through a proxy, directly, or reject it. FINAL handles connections that don’t match any preceding rules.

Best for: Everyday use after checking the rules and fallback behavior.

Proxy

Sends connections covered by proxy routing through the selected proxy. Use it to check whether the issue comes from Config routing rules.

Best for: Temporarily testing the server connection and troubleshooting differences in routing rules.

Direct

Uses a direct connection. This does not mean a subscription is enabled; even with a server selected, requests won’t be routed through it in this mode.

Best for: Checking whether your local network can access the destination directly.

6. Updating subscriptions and troubleshooting common import issues

Updating a subscription fetches the remote server list again; it doesn’t automatically fix every connection issue. Note the name of the server you’re using before updating. Afterward, check which entry is selected, since your service provider may have added, removed, or renamed entries. Don’t assume that manual changes will survive a remote update.

It saved successfully, but why are there no servers?

First check that the entry is set to Subscribe, then confirm that the URL is a server subscription—not a login page or Config URL. If an update returns an empty list or a format error, ask your service provider to verify the link and output format. Adding the same subscription repeatedly won’t fix the problem.

Should I connect through a proxy before retrying a timed-out update?

First confirm that your local network is working and the URL is complete. If you have a working server and the subscription URL needs to be accessed through it, connect to that server, then check Update via Proxy under Settings → Subscribe and retry. Enabling this option won’t create a connection if none is available.

The QR code was scanned, but the import failed. What should I do?

Check whether the scanned content is a supported protocol link or a complete subscription URL. If it’s a webpage, truncated text, or a string containing spaces, copy the original link again from its source. Don’t try to reconstruct missing credentials by hand.

It connects after import, but webpages won’t load. What should I check?

First make sure the newly imported entry is selected in Home, then check that Global Routing is set as expected. Briefly compare Proxy with Config. If it still fails, check the protocol parameters, system time, and DNS. Don’t delete all your configurations. Restore your original routing setting when you’re done testing.

For your first test, don’t add automatic connection conditions yet. Settings → On Demand triggers connections based on conditions; it doesn’t import or update subscriptions. Complete “import → select → test → browse” first, then configure automatic connections so you can tell what each change does.

Download Shadowrocket