A share link describes one server entry; a subscription URL retrieves and updates a list of entries. This guide is for users who already have connection details from their provider and are ready to import them into Shadowrocket: identify the link, check its protocol fields, then import, update, and test the connection. The domains, passwords, UUIDs, port combinations, and subscription token shown are all dummy values and cannot be used to connect.
1. Share links vs. subscription URLs: content and update behavior
The ss://, vmess://, vless://, and trojan:// prefixes identify the format of a single set of connection details. When imported, Shadowrocket parses the address, port, authentication details, and any additional parameters, then creates an entry in Home. A link name is only a label; it does not guarantee availability or speed.
Subscription URLs usually start with https://. They point to a collection of entries provided by your service provider. When you update a subscription, the app requests the URL again and refreshes the list with the returned content. But not every HTTPS URL is a subscription: account login pages, order pages, and help pages generally cannot be imported directly. Get the link from your service provider and confirm that it is a Shadowrocket subscription URL.
Two import types: a single entry or an updatable list
Single share link
- Usually contains connection details for one server.
- Useful for checking a specific address, port, and protocol.
- If server settings change, reimport the link or edit the entry manually.
- A successful import does not confirm that authentication, TLS, or network connectivity works.
Subscription URL
- Requests a collection of entries maintained by your service provider using one URL.
- The response may contain entries using one or more protocols.
- If addresses or authentication details change, update the subscription to retrieve the latest entries.
- A successful subscription update and a working connection for an entry are two separate checks.
Distinguish them by their purpose and returned content, not their length: a single share link can be longer than a subscription URL.
A standard server subscription is not the same as a complete Config. Importing a list of server entries does not mean the app has received DOMAIN-SUFFIX, GEOIP, IP-CIDR, or FINAL rules, nor does it mean DNS or Global Routing will be configured automatically as described by your provider. If your provider also supplies a configuration file, check which settings are managed by that file and which by the server subscription.
2. Fields in four common schemes
A scheme is the format name before the colon. It can help identify the protocol, but it does not tell you every connection setting. For example, two VLESS entries may use different transport methods and TLS settings. Copying only the address and UUID may leave out required fields.
| Format | Main details | What to check |
|---|---|---|
ss:// | Shadowsocks encryption method, password, address, and port; some formats also include plugin parameters. | The encryption method and password must match the server. Some fields may be Base64- or URL-encoded. |
vmess:// | Often a Base64-encoded JSON object containing the address, port, UUID, transport, TLS, and other fields. | Check the fields in the JSON, not just the link label. Field conventions can vary between export formats. |
vless:// | Usually includes a UUID, address, and port, plus query parameters for transport and security settings. | Check TLS, SNI, transport type, and related parameters. The protocol name alone does not mean TLS is enabled. |
trojan:// | Usually includes a password, address, and port, with additional parameters such as SNI and transport. | Tell the password apart from the UUID. Check the TLS server name and certificate requirements; do not disable certificate verification as a workaround for incorrect settings. |
The three lines below show readable structures only and do not provide a working service. The Shadowsocks example encodes aes-128-gcm:dummy-password as user information; the other two show where a VLESS UUID and a Trojan password go. The 443 port is an arbitrary example, not a requirement of these protocols.
ss://[email protected]:443#DEMO-SS
vless://[email protected]:443?encryption=none&security=tls&type=tcp&sni=example.com#DEMO-VLESS
trojan://[email protected]:443?security=tls&type=tcp&sni=example.com#DEMO-TROJAN
Common VMess share links encode the entire JSON object, so you should not try to infer the fields from how the link looks. The dummy JSON below illustrates the structure before encoding; it is not a vmess:// link you can paste to import. For an actual import, use the complete string supplied by your service provider. Do not assemble connection details based on this example.
{
"v": "2",
"ps": "DEMO-VMESS",
"add": "example.com",
"port": "443",
"id": "00000000-0000-4000-8000-000000000000",
"aid": "0",
"scy": "auto",
"net": "tcp",
"type": "none",
"host": "",
"path": "",
"tls": "tls",
"sni": "example.com"
}
3. Import a single share link into Shadowrocket
These steps use Home on iPhone / iPad as an example. Before you start, keep a copy of your existing configuration and make sure the clipboard contains only the complete link you intend to import. Chat apps may copy explanatory text, line breaks, or Chinese punctuation along with the link, which can prevent it from being recognized. Do not copy only the domain or omit the scheme at the beginning.
- Copy the original link. Get a single share link from your service provider and copy it in full, from the scheme through the final parameter. Do not remove parts just because the encoded string looks long.
- Return to Home. If a clipboard import prompt appears, check the source and confirm the import. If iOS asks for paste permission, allow it only when you need to read this link.
- If no prompt appears, check the import options. Look for the add option and clipboard import action on Home. If you add an entry manually, set Type to the actual protocol and enter each field supplied by your service provider. Do not paste the entire share link into Address.
- Check the new entry. Open its details and confirm Type, Address, Port, password or UUID, and TLS, SNI, and transport settings. Make sure you have not imported an older entry with the same name by mistake.
- Select and test the entry. Return to Home, select the entry, then check Global Routing, the connection status, and Connectivity Test. When establishing a VPN connection for the first time, follow the system prompt to allow adding a VPN configuration.
Text after # in a link is usually a label; text after ? is usually made up of parameters, separated by &. Special characters in passwords may be URL-encoded, and changing them by hand can alter the meaning of a field. If fields are missing after import, first ask your service provider for a fresh export compatible with Shadowrocket instead of repeatedly trying different passwords or ports.
4. Add subscriptions as Subscribe entries and update them separately
The subscription example https://example.com/sub?token=xxxx is for illustrating the format only; it cannot retrieve any entries. The path and token are set by your service provider. Changing an arbitrary URL to look like this will not create a subscription. A complete subscription URL often acts as an access credential, so protect it as carefully as a single share link.
- Confirm the type of link. Get a subscription URL from your service provider and make sure it is not a user dashboard URL or a page that requires a browser login.
- Add a subscription entry. On Home, tap Add, set Type to Subscribe, enter the complete address in URL, add a label you can recognize, and save.
- Check the response. Look for server entries under the subscription. An HTML page, login prompt, or formatting error does not count as a valid subscription response.
- Update it later. On Home, update the relevant subscription. To change its update behavior, check the related options under Settings → Subscribe. Automatic updates do not replace an initial manual check.
- Test a specific entry. After the update, select the server you want to use and run a connection test. A changed list does not mean every entry will work on your current network.
Updates may change addresses, names, or authentication fields maintained by your service provider, so do not treat manual edits to subscription entries as permanent. Note any personal adjustments you need to keep. When troubleshooting, distinguish a failed subscription request from a failed connection to an entry, rather than repeatedly deleting your entire Config to fix one subscription URL.
5. Check Global Routing after importing
Seeing a server in the list only means its details were parsed and saved. Access also depends on the selected entry, rule matching, DNS, TLS, and server authentication. To isolate an issue, change one variable at a time: verify the entry fields first, check the routing mode next, then compare the test results.
Config: check the current configuration
RecommendedWhen using an existing, verified configuration for everyday use, let its rules determine where traffic goes. Whether traffic uses Direct or a proxy depends on the matching rule and policy; traffic that matches no rule is not necessarily sent directly.
Best for: a verified rule set that routes traffic by domain and IP range
Proxy: temporarily isolate rule-based routing
Test the connection in Proxy mode to reduce the effect of ordinary routing rules on the results. This will not fix an incorrect password, an expired subscription, or a mismatched SNI. Restore the original mode when troubleshooting is complete.
Best for: checking whether an access issue is related to routing in the current Config
Direct: check the direct-connection baseline
Check how the current network behaves in Direct mode. If a website opens in Direct mode, that does not prove that the imported proxy entry can connect.
Best for: comparing direct access on your local network with a proxy connection
If you use Scene in Global Routing, also check the selected scene and its conditions. Otherwise, a change caused by switching scenes could be mistaken for a failed subscription. On Demand controls when a connection is established based on conditions; it does not fill in missing authentication details or create routing rules.
- Only one domain has an issue: Check the order and policy of the relevant DOMAIN-SUFFIX rules in the current Config, as well as where FINAL sends traffic.
- Domain and IP tests give different results: Check the DNS response and IP-CIDR or GEOIP matches before attributing the issue to the protocol.
- Latency is measurable, but the service still fails: A latency result only reflects the response under the test conditions. Also check access to the target site, TLS, authentication, and other connection steps.
- The result changes when you switch modes: Note the mode, selected entry, and failing destination before and after the change. Then restore settings one at a time so you can identify the cause.
6. Common questions about importing and updating
I copied a link. Why didn't an import prompt appear on Home?
First check that the clipboard contains the complete scheme, has no extra text, and that system paste permission allows access this time. Then check the add options on Home. For a subscription, choose Type → Subscribe; do not enter an HTTPS subscription URL as a server Address. If the link still is not recognized, ask your service provider for a compatible format.
The subscription updated successfully. Why can't I connect?
First confirm that you updated the right subscription, then select an entry from it again. Check Global Routing, the server Port, authentication details, SNI, and transport, then run Connectivity Test. A successful update only confirms that the subscription was retrieved and parsed; it does not confirm server authentication or access to the target site.
The subscription keeps timing out. Should I enable Update via Proxy?
First make sure the subscription URL is complete and still valid. If you already have a working connection but cannot reach the subscription URL over your current direct network, check Update via Proxy under Settings → Subscribe and try updating again. Enabling this option alone cannot provide a working route if you have no usable proxy. Check your network and the URL from your service provider first.
Can I recreate the original entry with only the server address and port?
Usually not. Shadowsocks also needs an encryption method and password; VMess and VLESS need their respective identity details; Trojan needs a password. Some entries also rely on TLS, SNI, or transport settings. Keep the complete original details. If the link has been exposed, ask your service provider to replace the affected credentials or subscription token.
Get Shadowrocket and follow the setup guide
Two ways to get the app: Shadowrocket for iPhone / iPad is a one-time $2.99 purchase on the App Store. The developer is Shadow Launch Technology Limited; check the App Store listing for system requirements. The Mac (Apple silicon / Intel), Windows, Android, and Linux versions are free. Visit the all-platform download page to choose your platform, or read the setup guide if you already have the app.