Skip to content
subscription-link.md

What Is a VPNSubscription Link? A Complete Beginner’s Guide to Getting, Importing, and Updating It

Your subscription link tells a VPN client where to get its configuration. Learn where to find it in your account panel, how to import it on different platforms, when to update it, and what to do if it’s exposed.

What Is a VPNSubscription Link

A VPN subscription link gives a client access to your connection configuration. It usually contains account-specific credentials. Once retrieved, the client can obtain the server address, port, protocol, and authentication details needed to connect. Copying the link is only the first step: traffic may be routed according to the client’s settings only after you import it, choose a route, and enable the connection.

Think of a subscription as a source for configuration, not as a single fixed server. When the service changes its routes, the client can retrieve the updated details by refreshing the subscription. If you’ve saved only an individual server’s details manually, you’ll usually need to handle later changes yourself. A subscription is not a client installer or a plan: installing the software, importing its configuration, and confirming that your account is active are separate steps.

Identify what you have before deciding where to paste it
ItemMain purposeCommon misconception
Subscription linkLets a compatible client retrieve routes or a complete configurationOpening it as a regular webpage will show a connect button
Single-server sharing linkImports connection details for one routeImporting it will automatically sync every route
Account panel addressManage your account, plan, and subscription accessThe panel login page belongs in the subscription field
Client installerInstalls software that reads configuration and establishes connectionsInstalling the app automatically connects you to international routes

Get a Subscription from Your Account Panel

VPNPut subscription links are available after you log in. Start with the account overview in the panel and confirm that your account and plan are active, then use the subscription option provided there. VPNPut doesn’t require an email address. Keep your account credentials secure, and don’t mistake convenient panel access for a reason to neglect password security.

  1. Choose your client first. Check the panel’s instructions to see which subscription formats the client accepts. Don’t copy a random link and try it repeatedly.
  2. Use the copy option in the panel. If it offers different clients or configuration types, choose the one that matches your software. Labels may change, so follow the instructions in the current panel.
  3. Paste the entire link into the subscription field. Don’t include quotation marks, line breaks, or extra spaces, and don’t remove query parameters yourself; they may be needed for authentication or format selection.
  4. Save, then refresh the subscription. Check that a route list or configuration appears—not just a new, empty subscription name.

Don’t paste the link into a browser just to “test” it. The browser may download a configuration or display encoded text, but neither result proves that a client can use it. The URL may also remain in your browsing history or sync records. Check the refresh result and any error messages in a compatible client instead.

Client Compatibility and Platform Differences

Supporting a protocol and supporting a subscription format are not the same thing. Shadowsocks, VMess, Trojan, VLESS, Hysteria2, and TUIC are connection protocols or protocol suites. A subscription may return a list of servers or a complete configuration for a particular client. A client’s support for a protocol doesn’t mean it can parse every subscription link a provider offers.

A complete configuration may also include proxy groups, routing rules, and DNS settings; a subscription that contains only a server list usually doesn’t provide these. Before importing, check the client’s documentation, runtime core, and configuration format. These are general technical distinctions, not a claim that VPNPut offers all of the protocols listed. Follow the access method recommended in the panel rather than choosing based on protocol names alone.

Windows, macOS, and Linux

Desktop clients usually let you add a remote URL in a page called “Profiles,” “Subscriptions,” or something similar. After saving it, you may also need to select the configuration. The system proxy affects only apps that follow system proxy settings; command-line tools, games, and some standalone apps may need separate configuration. TUN mode generally involves a virtual network interface, permissions, and routing changes. Follow the client’s documentation—seeing a server list doesn’t mean all apps are connected.

Android and iOS

Mobile clients may let you import from a link, scan a QR code, or open a link through the system share menu. A QR code can contain the same sensitive credentials, so don’t share it publicly. The VPN indicator in your system status bar only shows that the relevant network interface is enabled; it doesn’t mean every app uses the same route. Check app exclusions, routing rules, and actual access results.

VPNPut clients for Android, Windows, macOS, and Linux are available after login. On iOS, access depends on whether your plan is active. Check the current instructions at the panel’s download page; don’t assume that iOS has the same access requirements as other platforms.

Connection Checks After Import

A successful configuration download only confirms that the subscription request and parsing completed. A working connection also depends on route authentication, exit selection, DNS resolution, and app routing. Use the checklist below and change one setting at a time. That makes it easier to identify the cause than switching modes, routes, and DNS settings all at once.

  • ✅ Configuration enabled: Make sure the selected configuration is the one you just imported, not another one saved in the app.
  • ✅ Route available to select: Confirm that the proxy group contains servers and that you’ve selected the target region. For an automatic selection group, also check which exit is currently selected.
  • ✅ Connection mode matches your needs: System proxy, TUN, and an app’s own proxy settings apply to different traffic. Don’t assume that one mode means all traffic is routed through the client.
  • ✅ Test the service you actually need: Visit the relevant website or app, then check your browser’s exit route on the My IP page. A browser result doesn’t represent every app.
  • ✅ Check for conflicts with other network tools: Look for other proxies, virtual network interfaces, or corporate network policies that may affect routing. Don’t change settings on a managed device without permission.

If your exit route has changed but the destination is still unreachable, check routing rules and DNS next. Rule-based mode may send some domains directly. An app may also use its own encrypted DNS, bypassing the resolution path you expect the client to use. A DNS leak means queries are going through an unexpected resolver path; it doesn’t mean the subscription import failed, and one failed page load isn’t enough to confirm a leak.

When to Update a Subscription and How to Troubleshoot Failures

You don’t need to refresh your subscription every time you visit a website, and there’s no update schedule that works for every client. If your software supports automatic updates, follow the panel’s recommendation or the client’s default settings. Otherwise, refresh it when the service announces route changes, the list hasn’t changed in a while, or older servers stop working. Refreshing the configuration won’t renew your plan or restore used-up data.

Refreshing a complete configuration may overwrite local changes in some clients. If you’ve added custom rules, check whether the software supports separate overrides or merging before updating. Don’t keep custom edits only in a copy that a remote configuration can overwrite. Store backups containing subscription links or authentication details as sensitive files.

Troubleshoot based on where the error occurs

  • Fetch fails, times out, or reports a certificate error: First check your network, device clock, and the full URL. Don’t disable certificate checks to bypass the error. If the client lets you choose the network route used for subscription updates, check its settings according to the documentation.
  • Download succeeds but parsing fails: First check that the subscription format matches, the client supports the returned content, and the software is up to date. A regular login page or error page may also be downloaded as if it were a configuration.
  • The list is empty: Check whether you selected the wrong configuration, applied a filter, or have an account or plan status issue. Don’t assume all routes are unavailable.
  • Servers appear but won’t connect: Keep the subscription, try a different exit route with the same destination, then check routing rules, DNS, and your local network. If the issue persists, continue troubleshooting in Troubleshooting.

When contacting support, start with your platform, client name, the error text, and the steps that triggered it. Before sharing a screenshot, hide account credentials, the full subscription URL, QR codes, and server authentication fields. Don’t upload the entire configuration file publicly just to show an error.

What to Do After a Link Leak

If a complete link has appeared somewhere public or was shared with an untrusted tool, treat it as exposed. Deleting it from a post won’t invalidate copies others may have made. Changing your login password may not rotate a separate subscription token, so confirm how the link can be revoked.

  1. Remove the public content first. Delete the visible link, QR code, and attachments containing credentials, and stop sharing them.
  2. Look for a subscription reset option in the panel. If the current panel offers a reset or token rotation option, read the prompt and follow it. If you can’t find one, contact ticket support to confirm how to revoke the old credentials. Don’t assume that changing your password is enough.
  3. Confirm what the old credentials’ invalidation covers. Invalidating an old subscription URL doesn’t necessarily invalidate server credentials already downloaded from it. Ask support whether those connection credentials also need to be rotated.
  4. Update all your own clients. Replace the old URL, retrieve the configuration again, and remove the old subscription, clipboard history, and unnecessary backups.

Remember: keep your subscription URL in a trusted client, refresh it when configuration changes, and troubleshoot connection issues one step at a time along the actual network path. This avoids wasted effort and keeps account-specific access credentials from spreading when you ask for help.

Start free