In-Depth Guide

How to Import & Update Subscription Links

Subscription-related issues are where beginners get stuck most often. This article explains what a subscription link is, how to use it, and what to do if it stops working.

What Is a Subscription Link

A subscription link is an address that contains information for a group of nodes. When your client reads this link, it automatically generates the corresponding node list — you don't need to add each node manually. Think of it as "subscribing to a continuously updated node list": whenever the provider updates their nodes, all you need to do is re-fetch the subscription once, and your client's node list updates along with it — no reconfiguration needed.

A typical subscription link usually starts with http:// or https:// and looks like a long string of characters (often encoded and hard to read) — that's completely normal. You don't need to understand what's inside; just copy it in full and paste it into your client. Don't manually edit or remove any characters, or the import will fail.

This site doesn't provide subscription links themselves — we only offer the client software and usage guides. You'll need to get your own subscription link from your node/service provider.

How to Import a Subscription Link

The wording varies slightly between clients, but the process is basically the same:

  1. Find the Subscription Settings

    In the client's main menu, find "Subscription Settings," "Subscription Management," or a similarly named option (both v2rayN and v2rayNG have it in the main menu).

  2. Paste the Subscription URL and Save

    Click "Add" and paste the full subscription link into the address field. Before pasting, it's best to copy it in full from the original source to avoid missing characters, extra spaces, or line breaks from manual typing. You can give the subscription a recognizable label, then save it.

  3. Run the Update

    After saving, you'll need to manually trigger an "Update Subscription" (some clients do this automatically right after adding). The node list will then populate with every node in your subscription, each usually shown with an easy-to-recognize name (e.g., region or line number).

  4. Confirm the Import Worked

    Seeing multiple nodes appear in the list means the import succeeded. If the list is empty or shows only one or two nodes, it's usually not an operational mistake but an issue with the subscription itself — try running the update again first, and if that doesn't help, double-check whether the link is complete or has expired.

No Subscription Link? Other Ways to Import

If what you have isn't a full subscription link but a single node share link (usually starting with a protocol like vmess:// or vless://) or a QR code, you can add it directly:

  • Single node link: choose "Import from Clipboard" on the node list screen — the client will automatically detect and add this one node, no subscription setup needed.
  • QR code: mobile clients (like v2rayNG) usually support "Scan QR Code" for a direct import, and desktop clients may also support recognizing a QR code from a screenshot.
  • Local config file: some clients support "Import from File" — if your provider gave you a config file instead of a link, use this method.

These methods just differ in how the node gets added — once it's in, selecting the node and enabling the proxy works exactly the same as with a subscription link.

How to Update Your Subscription

Node providers typically rotate their nodes from time to time, so subscription content needs to be refreshed periodically — otherwise you're likely to run into expired nodes or slower speeds:

  1. Manual Update

    Most clients have a dedicated "Update" button on the subscription settings page, or an "Update Subscription" option in the main menu/tray icon — just tap it to re-fetch the latest node list. When you're just getting started, it's a good idea to stick with manual updates so you can confirm the result each time.

  2. Set Up Auto-Update (Optional)

    Some clients let you configure an "auto-update interval" (e.g., every 24 hours) in the subscription settings. Once enabled, the client automatically fetches the latest nodes in the background on that schedule, so you don't have to update manually each time. Consider turning this on once you're comfortable with how manual updates behave.

  3. Diagnosing Node Issues After an Update

    If the number of nodes drops sharply or disappears entirely after an update, or a node that used to work suddenly stops connecting, it's usually because the subscription URL itself has expired or the provider changed its nodes — not a problem with the client. In this case, contact your node/service provider to confirm the subscription status or get a new link.

Can I Use Multiple Subscriptions at Once? Yes. Most clients let you add several subscriptions — when you update, their nodes are merged and displayed in separate groups without interfering with each other, so you can switch between groups as needed.

FAQ

All My Nodes Disappeared After Updating the Subscription — What Do I Do?

First check whether the subscription URL is still within its valid period — it's most likely expired or been disabled, and you'll need to get a new one from your provider. If you've confirmed the subscription is still valid, check Connection Troubleshooting to rule out a network issue on the client side.

Can I Manually Add a Single Node Without Using a Subscription Link?

Yes. Most clients also support pasting a single node's config or scanning a QR code to add it — it's just more tedious to maintain one by one. We still generally recommend using a subscription link for unified management; see "No Subscription Link? Other Ways to Import" above.

Do I Need an Active Network Connection to Update a Subscription?

Yes — updating a subscription is itself a network request, so your device needs some kind of working network connection (it doesn't need to already be connected through the proxy). If your local network has unstable access to the subscription URL, try switching networks (e.g., between Wi-Fi and mobile data) and retry.

Can I Use the Same Subscription URL on Multiple Devices?

In most cases, yes — the same subscription link can be added separately in clients on your phone, computer, and other devices without them interfering with each other. Whether there's a limit on the number of devices depends on your specific node/service provider's rules.

Got a New Device — How Do I Quickly Move My Subscription Over?

There's nothing to "migrate" — just add the subscription again on your new device's client and paste in the same link. The result is identical to your old device, with no data sync involved.