Shadowrocket Share Link Formats: ss://, vmess://, vless://, trojan://, and Subscription URLs

A share link describes one node; a subscription URL points to an updatable list of nodes. This guide breaks down common link formats and explains how to import each one into Shadowrocket.

At a glance

If you already have a link from your provider, check its prefix before choosing an import method: import ss://, vmess://, vless://, and trojan:// links as individual entries. Add an HTTPS URL with Subscribe only when your provider identifies it as a subscription. After importing, check the list, connection, and routing separately.

Share links vs. subscription URLs

A single share link contains connection parameters and creates one local entry when imported. A subscription URL points to a list maintained by a provider; when you update it, the app requests that URL again and parses the response. A subscription is still a subscription even if it currently returns just one node. Conversely, a share link copied from a list won't update automatically when that list changes.

Import a subscription: keep the list linked

Recommended

If your provider offers a subscription and maintains its list, save the original subscription URL. Refresh the subscription group later instead of copying share links one by one again.

Best for: keeping up with changes to a list when you already have a subscription.

Import a single link: save connection parameters

This adds only the entry described by the link. If the provider changes the address, port, or credentials, check the new parameters and replace the old entry.

Best for: when you have just one share link or want to check a single entry.

Bottom line: don't enter an arbitrary HTTPS URL in Subscribe

First confirm that your provider identifies the URL as a subscription for Shadowrocket. Login pages, help documents, and subscription URLs can all start with https://, and a list URL may not include /sub. The prefix, path, or a token parameter alone can't tell you what the response contains.

Breaking down ss://, vmess://, vless://, and trojan://

The domains, passwords, and identifiers below are illustrative only and cannot be used to connect. The ports are sample values, not fixed ports for these protocols. When importing, keep the full link provided by your service, including parameters after ? and the remark after #.

4 formats
Single-link prefixes covered in this guide
8388
Server port in the Shadowsocks example below
443
Server port used in the TLS examples below

Shadowsocks:ss://

ss://[email protected]:8388#demo-ss

This is a common format that places authentication information before @. Here, the Base64URL-encoded content is aes-128-gcm:dummy, representing the encryption method and a sample password. The server and port follow @. Base64URL is an encoding, not password protection. Older formats may encode more of the link, so a server address that isn't visible in plain text doesn't necessarily mean the link is broken.

VMess:vmess://

A common format puts a Base64-encoded JSON payload after vmess://. The example below shows decoded fields, not a share link you can paste directly. add and port are the server address and port, id is the user identifier, and ps is the remark. In this example, net is ws, so also check the WebSocket host and path, along with the TLS sni.

{
  "ps": "demo-vmess",
  "add": "vmess.example.com",
  "port": "443",
  "id": "11111111-1111-4111-8111-111111111111",
  "net": "ws",
  "host": "vmess.example.com",
  "path": "/demo",
  "tls": "tls",
  "sni": "vmess.example.com"
}

VLESS and Trojan: vless:// and trojan://

vless://[email protected]:443?encryption=none&security=tls&type=tcp&sni=vless.example.com#demo-vless
trojan://[email protected]:443?sni=trojan.example.com#demo-trojan

How to import links into Shadowrocket: add a single link or Subscribe

These steps use the iPhone / iPad interface. Copy the link from its protocol prefix or https:// through to the end. Don't include quotation marks, extra text from a chat app, or trailing punctuation. The examples in this guide are for checking the format only; use your own complete link.

Import from Home: choose the action for your link

Single share link
  • Copy the complete protocol link and return to Shadowrocket's Home. If iOS asks whether to allow pasting, confirm the source is trusted and allow it. If the app recognizes the link, follow the prompt to add it.
  • If no import prompt appears, check the clipboard contents, including the prefix and the end of the link. If your provider also supplies a QR code for the same entry, scan it from Home. You can also tap + in the upper-right corner and enter the provider's details manually, selecting the appropriate Type.
  • After adding the link, check Home for a new entry and open it to verify the protocol, address, and port. A dismissed alert doesn't confirm that the entry was saved.
Subscription URL
  • Go to Home → + → Type → Subscribe and paste the full URL from your provider into URL. Example: https://example.com/sub?token=xxxx.
  • After saving, return to Home and check that the subscription group appears and that its node list has loaded. Seeing the group name alone doesn't confirm that the list was parsed successfully.
  • To get your provider's latest changes, use the subscription group's update action in Home, then check its entries. You don't need to add the same URL again just to refresh it.

For a single link, verify the individual entry; for a subscription, verify the group and its list. Test the connection separately for both.

After importing: tell connection issues from routing issues

  1. Check the entry first. Open the target node and confirm its protocol, server, and port match the original link. Entries with the same name aren't necessarily the same node. If an older entry exists, don't rely on the remark alone to identify the one selected.
  2. Then check the connection. In Home, select the verified entry and turn on the connection switch. If it won't connect, check that the credentials are still valid and that TLS, sni, transport, and path match the provider's details. If the app accepts a link, it has parsed the entry; that doesn't mean the remote service is available.
  3. Finally, check routing. Go to Home → Global Routing and check the current mode. Direct doesn't use the selected proxy node, so it can't confirm whether that node handled the request. In Config, requests are matched against the active rules; a successful request may still match DIRECT. To check whether routing rules are involved, temporarily select Proxy, retry the same request, then restore your previous setting.

Common import and subscription update issues

I copied a vmess:// link. Why didn't a new entry appear in Home?

First, make sure you copied the complete string starting with vmess://, not decoded JSON or a preview truncated by the chat app. Then check whether iOS showed a paste permission prompt. If the link still isn't recognized, ask your existing provider to confirm its format and use the QR code or original parameters they supplied. Don't try to fix it by changing the encoding manually.

The subscription group appeared. Why is it empty?

Update the group once, then check that the saved URL is complete, especially any authentication parameters after ?. If the provider returns a login or error page, it can't be imported as a list even if the URL opens in a browser. Check with your existing provider whether the subscription is valid and correctly formatted.

The subscription updated. Why didn't my previously imported entry with the same name change?

An update affects the corresponding subscription group; it doesn't replace separately imported entries based on their remarks. Expand the group in Home and select the updated entry there. Before deleting an old entry, make sure it's a separate entry and not part of the group.

Can I share the original link or QR code when troubleshooting?

Don't share the original content publicly. A single link may contain a password or UUID, while a subscription URL may contain access credentials; a QR code may encode the same information. When reporting an issue, provide the protocol prefix, import steps, error text, and screenshots with sensitive fields redacted.

Shadowrocket download and setup guide

Get the iPhone / iPad app from the App Store for a one-time purchase of $2.99; check the App Store listing for system requirements. The Mac (Apple silicon and Intel), Windows, Android, and Linux versions are free. The download page lists options by device, and the setup guide covers connecting after you add an entry.

Download Shadowrocket