How to Import vmess:// and vless:// Links: Single Servers vs. Subscriptions

Learn how vmess:// and vless:// links work, how subscription URLs update, and how to import configs from the clipboard or a QR code in v2rayN and v2rayNG.

At a glance

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

Recommended

Keeps 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
add is the address; port is the remote port
Identity and transport
id is the user ID; net is the transport
Display name
ps is 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 example example.com:443
Transport and security
The query parameters may include type and security
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

  1. Paste a Share Link

    Copy the entire link, starting with vmess:// or vless://, 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.

  2. 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.

  3. 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.

  4. 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.

  5. 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

  1. 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.

  2. 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.

  3. 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.

  4. 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.

  5. 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

Download Clients