Tutorial

How to Use Clash Subscription URLs: Complete Import & Auto-Update Guide

Subscription is the most common—and lowest-friction—way to use Clash. Most people do not enter nodes one by one; they import a subscription URL from their provider and let the client handle the rest. This guide covers what subscriptions are, how to import them, auto-update settings, and troubleshooting, start to finish.

What Is a Subscription URL?

A subscription URL is simply a link your client fetches to pull a batch of nodes at once—sometimes rules and policy groups too. Your provider or self-hosted panel generates it, for example:

https://example.com/subscribe?token=your-private-token

The token in that link is your account credential—anyone with it can use your quota. Do not screenshot it publicly, post it in group chats, or upload it anywhere. This site explains how to use Clash; it does not provide subscriptions or nodes.

Why Subscriptions Beat Manual Entry

Step 1: Import the Subscription

Using Clash Verge Rev on desktop as an example (other clients are similar):

  1. Copy your subscription URL;
  2. Open the client and go to Subscriptions / Profiles;
  3. Paste the URL and click Import;
  4. Wait for the download, then select that profile so it becomes active.

After import, you should see nodes or policy groups under Proxies. On mobile (e.g. ClashMeta for Android), tap + on the profiles screen, choose import from URL, and paste the link—the flow is nearly the same.

Step 2: Enable Auto-Update

Nodes change; manual refresh gets old fast. Turn on auto-update:

Updates replace node data only—they do not reset which node you picked in a group, so auto-update is safe to leave on.

Advanced: Import a Local Config File

If you have a ready-made config.yaml, import that instead. You can also use proxy-providers to treat a subscription as a node provider, separating "subscription nodes" from "custom rules":

config.yaml
mixed-port: 7890
mode: rule

proxy-providers:
  my-sub:
    type: http
    url: "https://example.com/subscribe?token=xxx"
    interval: 86400   # Auto-update interval (seconds)
    path: ./providers/my-sub.yaml

Here interval: 86400 means refresh every 24 hours (86,400 seconds). This suits users who maintain a custom config long term.

What If Updates Fail?

Failed subscription updates are common; causes usually fall into a few buckets:

Managing Multiple Subscriptions

If you have more than one subscription, one profile per URL keeps things clear: keep several profiles in the client and switch as needed—they stay independent. Do not cram unrelated subscriptions into one config; when something breaks, debugging node name clashes and conflicting rules gets painful.

To combine nodes from several subscriptions, prefer proxy-providers: each subscription as its own provider, then orchestrate with policy groups. You get one pool of nodes and can tell quickly which subscription failed.

Subscription Security Tips

Summary

Import subscription → enable auto-update → pick a node: three steps and Clash is running. Subscriptions automate node maintenance so you can focus on using the tool. To understand each section of a config file, read Documentation · Config File Structure; for writing rules, see our article Clash Rule-Based Routing Explained: A Practical Guide to Writing rules.

One last note: a subscription only fetches and maintains nodes—it does not fix slow or unstable lines. If performance is poor after import, look at node quality, not the import step. Once import, update, and troubleshooting feel natural, switching providers or clients follows the same playbook and gets faster every time.


Continue reading