When you receive a server link or QR code, first check whether it contains a single server config or an address that retrieves a server list. Import a single config once; save a subscription URL and refresh it to get the list. The steps below cover v2rayN on desktop and v2rayNG on Android, then help distinguish import errors, subscription update failures, and connection problems.
Share Links vs. Subscription URLs
Common vmess:// and vless:// links each contain one server config. The client parses the link and saves its settings locally; it doesn't need to fetch a list from a website first. You can paste multiple complete links on separate lines to add several servers at once, but that won't turn them into an updatable subscription.
Subscription URLs usually start with https://. The client saves the URL and fetches a server list from the provider when you update it; the list can include both VMess and VLESS servers. Since regular web pages also use https://, the prefix alone doesn't identify a subscription. Look for an entry explicitly labeled as a subscription URL and specifying supported clients on the provider's site. Don't enter a login page URL.
Choose an Import Method
Add a subscription URL
RecommendedKeeps the list tied to its source. When the servers change, update the corresponding group; the client uses the newly returned list for that group rather than replacing links one by one.
Best for: multiple servers from one source that changes its list periodically
Import a single server link
Saves the received config as a local copy. If the provider changes the port or identity settings, get a new link or update the settings using the provider's instructions.
Best for: adding one server or temporarily copying a specific server to another device
Fields in VMess and VLESS Share Links
The two link formats look different, but keep the entire link intact when importing either one. In particular, don't remove the parameters after the question mark to shorten the link: a correct server address and port don't guarantee that the transport and security settings are correct.
Two Common Link Formats
VMess: Encoded Config Data
- Prefix
vmess://- Typical payload
- Base64-encoded JSON
- Server
addis the address;portis the remote port- Identity and transport
idis the user ID;netis the transport- Display name
psis usually the server label
Base64 is an encoding, not encryption. You don't need to decode it to import the link, and you shouldn't submit the payload to an online decoding tool.
VLESS: Address and Query Parameters
- Prefix
vless://- Identity
- The user ID is usually before
@ - Server
- After
@come the address and remote port, for exampleexample.com:443 - Transport and security
- The query parameters may include
typeandsecurity - Display name
- The text after
#is usually the server label
Here, 443 only illustrates the field position; use the port in the config you received.
v2rayN: Clipboard, Screen QR Codes, and Subscription Groups
These steps use the Chinese-language interface of v2rayN 7.x on Windows. Import single servers from the “Servers” menu; save and update subscriptions from “Subscription Group.” Menu labels and parentheses may vary slightly between minor versions.
Desktop Steps
Paste a Share Link
Copy the entire link, starting with
vmess://orvless://, then return to the v2rayN main window and choose “Servers” → “Import bulk URLs from clipboard.” You can also press Ctrl + V in the main window. To import multiple links, put one complete link on each line without list numbers or chat text.Scan a QR Code on Your Screen
If you received a server QR code, display the full image on your desktop, then choose “Servers” → “Scan QR code on screen.” Leave a clear margin around the code and make sure no window covers it. If you already have the share link, use the previous method; there's no need to turn the text into a QR code.
Save a Subscription Group
For a subscription URL, open “Subscription Group” → “Subscription Group Settings.” In the group window, click “Add,” enter a recognizable alias and the complete URL, then save and return to the main window. The alias is only for identifying the source; it isn't sent to the subscription service.
Update the Current Subscription
Select the group you just saved, then choose “Subscription Group” → “Update current subscription (without proxy).” For the first import, update only this group so you can check which list was returned. If the group appears but contains no servers, first make sure you've run an update.
Check the List and Servers
Check that the expected protocols and labels appear in the list, then open an entry to verify its remote address and port. If the main window is showing another group after import, switch the list view before checking; otherwise, you may keep pasting because you can't see the new entries.
v2rayNG: Paste, Scan, and Update on Android
These steps use the Chinese-language interface of v2rayNG 1.9.x. Use the “+” in the top-right corner to import a config from text or a QR code; use “Subscription group settings” in the top-left menu to enter a subscription URL. Both methods add servers to the config list, but subscriptions also require fetching the list.
Android Steps
Copy the Complete Link
On your Android phone, copy the complete server link, open v2rayNG, and tap “+” in the top-right corner → “Import config from clipboard.” If you copied an entire chat message, remove quotation marks, list numbers, and explanatory text first, while keeping the link's own symbols and encoding intact.
Scan a Code on Another Screen
Display the server QR code on a computer or another device. On your phone, tap “+” → “Scan QR code” and grant camera access if prompted. If the code is only displayed on this phone, ask the sender for the original link and use the clipboard option instead.
Create a Subscription Group
Open the top-left menu → “Subscription group settings,” tap “+,” enter a label and the subscription URL, then tap the check mark in the top-right corner to save. If the clipboard contains a subscription URL, use this option rather than entering it as a server address in a manual config.
Fetch the Server List
Return to the config list and switch to the subscription group you just added. Open the three-dot menu in the top-right corner and tap “Update current group subscription.” If your version only has “Update subscription,” use that option, then switch back to the target group to check the results.
Select a Server, Then Connect
Tap the server you want to use in the list, then tap the connection button at the bottom. Android may prompt you to authorize a VPN connection the first time. Seeing a server in the list only means its data was read; selecting it and starting the connection are separate steps.
Import Errors, Update Failures, and Connection Problems
First identify where the process failed. For a clipboard import error, check the original link. For a subscription update error, check the URL and the response. If servers appear in the list but won't connect, check the selected server and connection status. These are different problems; repeatedly retrying the same action won't resolve them all.
Why Does It Say 0 Items Imported?
Make sure you copied the link itself, not the title of a button on a webpage. Paste the text into a local editor and check that it starts with vmess:// or vless:// and hasn't been cut off by a line break. If it starts with the provider's https:// subscription URL, use the subscription group option instead.
Why Does Scanning Open a Webpage Instead of Adding a Server?
Check the label or context for the QR code. If it points to an account page, return to that page to find a subscription URL or server link intended for your client. If it contains a subscription URL, save the original URL in a subscription group and update it. Successfully scanning text only means the QR code was read.
Subscription Update Timed Out or Returned 403?
For a timeout, first make sure the device has a working internet connection, then update the target group once. If a proxy connection is already working on the same device, you can also try “Update current subscription (through proxy)” on desktop. If the server consistently returns HTTP 403, check with the provider that your subscription access and URL are valid. Don't troubleshoot by deleting query parameters.
The List Downloaded, but Where Are the Servers?
Switch back to the group you just updated and clear any search filters. If the update reports success but the group is still empty, ask the provider whether the subscription includes servers and whether its response format is supported by your client. Opening the URL in a browser doesn't prove it returns a server list; it could be a login page or an error message.
Why Isn't Traffic Going Through the Proxy?
In v2rayN, check the selected server and that the core is running. Then check whether “System proxy” in the tray menu is set to “Set system proxy automatically,” and test with a browser that uses the system proxy. In v2rayNG, make sure a server is selected and the connection is active. If per-app proxy is enabled, check that the app you're testing is included.
Verify Subscription Updates and Use Multiple Devices
- Check the group before the label. Two subscriptions can use the same server name. Check the same group before and after an update; if the previously selected server is no longer in the new list, select another server from that group. Matching labels don't mean the address and port are the same.
- Keep long-term manual configs separate. An update may replace entries in the target subscription group. To keep a server config for your own use, save its share link somewhere you control and import it into a group that isn't updated by that subscription. Keep in mind that a future update may overwrite manual changes to subscription entries.
- Update each device separately. If the provider's terms allow it, you can enter the same subscription URL on desktop and Android. Updating on desktop won't refresh your phone automatically. Both devices fetch server lists from the same source, but they don't sync the selected server, system proxy settings, or custom routing.