For a single link starting with vmess:// or vless://, import the node from your clipboard or a QR code. For an https:// link explicitly labeled as a subscription URL, add it as a subscription group, then update the group. When setting up v2rayN or v2rayNG for the first time, follow the menu paths below and use the field reference to tell an import problem from a connection problem.
Share Links vs. Subscription Links: Choose the Right Import Method
A share link contains one node configuration, ready to import when you copy the full link. A subscription link points to a location where the client can fetch a list of nodes. A subscription may contain just one node, so the number of nodes alone doesn't tell you which type of link you have.
Subscription links: update the whole group
RecommendedFollow the instructions to save the subscription URL in a group, then update it. When nodes are added, removed, or changed, you can usually update the group to get the latest list. If the subscription URL itself stops working, you'll need a replacement.
Best for: keeping a node list from one source up to date.
Share links: import one configuration as it is now
Each link contains one configuration. It won't update automatically when the sender makes changes. If they change the port or credentials, get a new link and import it, or edit the existing entry using the parameters they provide.
Best for: testing one node or adding a configuration to another device.
Not sure? Confirm what the link is for
An https:// link could also lead to an ordinary webpage. If the sender hasn't specified its purpose, ask whether it's a subscription URL or a webpage before adding it to a subscription group. The same goes for QR codes: they just encode text, and the decoded content determines what to do next.
v2rayN and v2rayNG: Import from Clipboard or QR Code
Copy the entire link, starting with vmess:// or vless://. Don't include the message title, quotation marks, or trailing punctuation. To scan a QR code, display it on your desktop screen and scan it with your phone, or show it on another screen for your phone's camera.
Where to import the same share link on desktop and Android
Desktop (v2rayN)
- From the main window, open “Servers” and select “Import bulk URL from clipboard.” Despite the word “bulk,” this option also accepts a single link. If the main window supports Ctrl + V, you can also focus the list and use that shortcut.
- To scan a QR code, display it fully on your screen, then select “Servers” → “Scan QR code on screen.” If it isn't recognized, enlarge it and leave some blank space around the edges, or use the original text link instead.
Android (v2rayNG)
- Copy the link and return to the main screen. Tap “+” in the upper-right corner, then “Import config from clipboard.” If prompted to access the clipboard, confirm in the system dialog.
- Tap “+” in the upper-right corner, then “Scan QR code.” Grant camera access and fit the entire code in the viewfinder. If the code is only on your phone, display it on another device or copy and import the original link instead.
Menu labels may vary slightly by version. After a successful import message, check the new entry's remarks and protocol in the list, then select it to test. Seeing it in the list only means the configuration was read.
Add, update, and check a subscription URL
Adding a group saves the URL; updating the group fetches its nodes. Do these as separate steps during the first import so you can tell whether the URL wasn't saved or the request or parsing failed.
- v2rayN: Open “Subscription group” → “Subscription group settings,” click “Add,” enter a recognizable remark and the subscription URL, then save. Back in the main window, select the group and choose “Update current subscription” from the “Subscription group” menu. Choose whether to connect through a proxy based on your network.
- v2rayNG: Open the menu in the upper-left corner → “Subscription group settings,” tap “+” in the upper-right corner, enter a remark and the subscription URL, then save. Return to the config list, open “⋮” in the upper-right corner, and tap “Update subscription.” If the interface has a group filter, select the relevant group to view the results.
- Check the results: When new entries appear, make sure their group, remarks, and protocol match the source information. Don't assume entries with the same remark are the same node; they may have different server addresses or ports. Keep manually added and subscription-based configurations separate so you don't mistake manual edits for settings that will persist after an update.
Some subscriptions return multiple lines of share links; others combine those lines into a Base64-encoded string. Base64 is encoding, not encryption, and the current client may not support every format. If an update reports no valid nodes, ask the provider whether the URL serves a supported subscription format rather than a login page or another type of configuration.
VMess and VLESS Share Link Fields
A common VMess share link consists of vmess:// followed by a Base64-encoded JSON object. Common VLESS links show the address and port directly, with transport and security settings often included as query parameters after the question mark. Here's a VLESS example for identifying fields: example.com is a sample domain, and the link isn't usable for a connection.
vless://[email protected]:443?encryption=none&security=tls&type=ws&path=%2Fdemo#WebSocket
| Purpose | Common VMess JSON fields | Common VLESS locations or parameters |
|---|---|---|
| Server address and port | add、port | Server address and port after @ |
| User ID | id, usually a UUID | User ID after the protocol prefix and before @, usually a UUID |
| Node remark | ps | The fragment after #, used to identify the entry in the list |
| Transport and additional settings | net; for WebSocket, may also include host and path | type; for example, type=ws indicates WebSocket and may be paired with host and path |
| Transport security | tls and, when specified by the configuration, sni | security and fields such as sni, when specified by the configuration |
In the example, path=%2Fdemo usually appears as /demo in the node editor; the path hasn't changed. Another common point of confusion: VLESS encryption=none and security=tls are separate settings. The former is the encryption parameter for the VLESS protocol; the latter specifies TLS for the transport. Don't treat them as the same switch, and don't enter the remote port from a share link as the client's local proxy port.
Tell apart import failures, empty updates, and connection failures
Why does the client say there’s no valid configuration even though I copied the link?
Check the beginning of the link. For a share link, make sure you copied the entire original text rather than a truncated preview in a chat window, then import it from the clipboard again. If it's a subscription URL, save it in “Subscription group settings” instead of repeatedly trying to import it as a single link.
The QR code opens a webpage. Can I still add a node?
Ask the sender to confirm whether the QR code contains a subscription URL or an ordinary webpage. If it's a subscription URL, copy the scan result, add it as a group, and update it. If it opens a webpage, get a valid share link or subscription URL from a trusted source.
Why is the group still empty after I saved the subscription?
Update the group once and check the error message. If it times out, check whether your current network can reach the subscription URL. If no valid nodes are found, check the subscription format and whether the link has expired. If the client reports an authorization error, ask the provider to confirm the subscription is still valid, then try again with a replacement URL.
Why does the connection test fail when the node appears in the list?
Open the entry for editing. Check the address and port first, then the transport and security settings, along with any associated path or server name. If other nodes from the same source work, ask the provider whether this configuration has changed. If the client reports an unsupported parameter, check whether your client version and core support that transport or security setting.