When importing for the first time, identify whether you have a subscription URL, a single server link, or the text returned by a subscription. Both the desktop v2rayN and Android v2rayNG can save subscription groups, but you still need to update the group after saving its URL. If the list is empty, check the selected group first, then determine whether the request failed or the response could not be parsed.
Subscription URLs vs. share links: choose the right import method
https:// only tells you that this is a web address; it does not mean it is a subscription URL. Copy the URL labeled for your client from the provider's subscription page, not the dashboard address in your browser after signing in. A subscription URL is requested by the client, which then receives content it can read.
Subscription group
RecommendedSave the subscription URL, then use the update menu to fetch the server list. When the provider changes its servers, update the same group instead of pasting each link again. Give the group a recognizable name, such as “Work subscription.”
Best for: A provider-issued subscription URL and a group of servers to maintain.
Import from clipboard
Copy a complete vmess:// or vless:// link, then import it from the clipboard. The client adds the current server configuration; it will not automatically refresh from a subscription just because the link came from one.
Best for: When you have a single share link or want to check whether one server configuration imports correctly.
A typical Base64 subscription encodes a list of share links, separated by line breaks, as a single block of text. Usually, you just enter the subscription URL in the client, which fetches and parses the content. If you only have a long block of encoded text, that is the subscription content—not a URL the client can request periodically. For automatic updates, ask the provider for a subscription URL.
v2rayN on Windows: Add and update a subscription group
These steps use the Chinese-language v2rayN 7.x interface on Windows. Open subscription group settings from the “Subscription Group” menu in the main window, not the system proxy menu. Saving a subscription and selecting the active server are separate actions; you do not need to change system proxy settings before the first import.
Open group settings
In the main window, select “Subscription Group” → “Subscription Group Settings” to open group management, then click “Add.” If a group with the same name already exists, check its URL before editing it or creating another one, so you can identify the right results.
Enter the subscription URL
In the edit window, enter a remark and paste the full subscription URL into “Optional address (Url),” then click “OK.” Keep any parameters after the question mark. Removing them may cause the server to return a sign-in page or deny access.
Update the selected group
Return to the main window and select the new group above the server list. Choose “Subscription Group” → “Update current subscription (without proxy).” For the first update, update only the selected group so it is easier to find the result in the log. If the menu shows “Update current subscription” with a separate proxy option, choose the direct update entry.
Check for imported servers
After the update, stay in the target group, clear any search terms, and check the list. For example, if the provider is expected to return three servers and you see three rows in the group, they have been imported. To check whether a server works, select one and run a separate connection test.
If you only have a single share link, you can skip group settings. Copy the full link, then choose “Server” → “Import bulk URLs from clipboard” in the main window. On Windows interfaces that support the shortcut, you can also press Ctrl + V in the main window. After importing, check the selected group first; if you cannot find the server, switch to the all-servers view.
v2rayNG on Android: Save the URL, then update from the home screen
These steps use the Chinese-language v2rayNG 1.9.x interface on Android. Use the top-left navigation drawer to manage subscription settings, and the three-dot menu at the top right of the home screen to start an update. The plus button on the home screen is mainly for adding servers; it is not the same as the plus button on the subscription settings page.
Open subscription settings
On the home screen, tap the top-left menu and open “Subscription Group Settings,” then tap “+” in the top-right corner of the settings page. If you cannot find the option, return to the server list first; do not stay on a server edit screen.
Save a subscription group
Enter a “Remark” and “Optional address.” If the edit screen has an “Enable updates” switch, leave it on. Tap the check mark in the top-right corner to save. Seeing the new remark on the group settings page confirms that the URL is saved, but does not mean the servers have been fetched yet.
Update the subscription
Return to the home screen and switch to the relevant group. Tap the three-dot menu in the top-right corner → “Update subscription.” If your version offers “Update current group subscription” and “Update all,” choose the current group. Wait for the update message, then check the server names and count in that group.
If you have just one share link, tap “+” in the top-right corner of the home screen → “Import from clipboard.” If you copied the link from a chat, make sure it does not include explanatory text, trailing punctuation, or line breaks. You do not need to save an empty subscription group before importing from the clipboard.
VMess vs. VLESS: Share link formats and fields
A vmess:// link often contains Base64-encoded data, but that is a different use of Base64 from encoding an entire subscription. The link represents one server configuration; a Base64 subscription bundles a list of links. Base64 is an encoding, not encryption.
VMess share link
- Prefix
vmess://- Typical contents
- A Base64-encoded JSON object
- Server fields
addis the address,portis the port, andidis usually a UUID- Transport fields
netspecifies the transport type; WebSocket configurations may includepath
When importing, keep the prefix and the complete content that follows it. Do not copy only the encoded part.
VLESS share link
- Prefix
vless://- Typical structure
- User ID, host, and port, followed by query parameters
- Connection parameters
typespecifies the transport type, andsecurityspecifies the security layer settings- Display name
- A fragment after
#, if present, is usually used as the server remark
Do not manually remove or edit parameters after the question mark, and do not try to convert VMess to VLESS by changing the prefix.
Empty server list after an update: Check the group, request, and format
The update says it finished, but the list is still empty. Why?
First switch to the group you just updated and clear any search or filter. If the “All” view shows servers but the target group is still empty, that does not confirm the update succeeded; the all-servers view may show previously imported servers. Check the update message or log to confirm that the target group was updated, and see whether it was skipped.
The update timed out or returned 401 or 403. Should I use a different import method?
Do not switch import methods yet. A timeout means the request did not receive a response in time. First check your network connection and the subscription domain, then try again. For a 401 or 403, check whether the subscription has expired, its token is invalid, or the URL was truncated. Do not paste a subscription URL into the single-server import field to work around the error.
The URL opens in a browser. Why can't the client read any servers?
A page opening in a browser only means the URL returned some content. Even with a 200 status, the response could be a sign-in page, an error message, or a configuration format the client does not support. Go back to the provider's subscription page and select the output format for your client. If the provider lets you copy a single link, import one as a comparison: if the single link imports but the group remains empty, check the subscription response and its format first.
The list has servers, but none connect. Should I import them again?
First distinguish importing from connecting. If the new servers appear in the list, the client has read their configurations. Test one server and check its address, server-side port, transport, and security layer settings against the connection error. The subscription download URL and the server's connection address are separate things to troubleshoot. Do not enter your local proxy port as the server's remote port.