This article addresses the common issue of “subscription links not updating”: clicking Update in the client does nothing, a timeout appears, the subscription is empty, or the link opens in a browser but won’t update in the app. Follow the steps below to troubleshoot your IP address, DNS, browser environment, and client settings. Most users can simply work through them in order.
1. Determine whether the problem is with the link or your device
A subscription link is essentially an online configuration URL that the client must be able to access and download node information from. First, copy the link into your browser’s address bar and open it. If the browser displays configuration text, a string of base64 characters, or a file download prompt, the link is probably working. If it won’t open, returns a 404 or 403 error, or spins indefinitely, the link may have expired, been blocked, or be inaccessible from your current network.
- Make sure you copied the entire link, especially the http/https prefix and any parameters at the end.
- Don’t import a “node link” as a “subscription link”—they use different formats.
- If you’re using the free nodes page on this site, copy the latest subscription URL and import it again.
2. Your IP address and network environment can affect subscription updates
In many cases, the reason a subscription link won’t update is related to your current public IP address. Some subscription URLs may restrict unusual requests, frequent refreshes, data center IP addresses, or public networks that have been abused. Try testing on mobile data, home Wi-Fi, and your workplace network to see if the issue occurs only on a particular network.
If the client is already connected to a proxy, updating the subscription may fail because the request is taking an indirect route. Try disconnecting the proxy and updating with your regular network connection. If the subscription URL itself requires a proxy, enable Update subscriptions through proxy or a similar option in the client. The exact name varies by app; in Clash-based clients, this option is usually under subscription settings, configuration management, or proxy update settings.
3. DNS errors can cause update timeouts
DNS translates domain names into IP addresses. DNS poisoning, ISP resolution issues, or an outdated local cache can all cause a subscription link to point to the wrong address. Try changing your system DNS to a well-known public DNS server, such as 223.5.5.5, 119.29.29.29, 1.1.1.1, or 8.8.8.8. After changing it, restart the client and try updating again.
- Windows: Change the IPv4 DNS settings in your network adapter properties.
- macOS: System Settings – Network – your current network – DNS.
- Android/iOS: Change the DNS in your Wi-Fi details, or test using mobile data.
It’s also a good idea to clear the client’s cache, as some apps save old DNS results. If you see options such as “Force refresh subscription” or “Clear configuration cache,” use those as well.
4. Browser environment and client import details
If the subscription opens in a browser but not in the client, check the client version and import method. Older clients may not support certain subscription formats, so update to the latest version. When importing, choose Import from URL, not the option to import a single node from the clipboard. You can name the subscription anything you like, but make sure the URL is complete.
Browser extensions can also complicate troubleshooting. Ad blockers, privacy extensions, and proxy extensions may allow a page to open in the browser even when the system’s proxy environment is different. Try opening the subscription in a private window or testing it in another browser. If the link requires you to log in first, the client usually can’t use your browser’s cookies, so that type of link isn’t suitable as a general-purpose subscription.
5. Quick checklist if it still won’t update
- Copy the subscription link again and remove any spaces at the beginning or end.
- Disconnect the proxy and try updating, then try again with “Update subscriptions through proxy” enabled.
- Switch networks and DNS settings to rule out IP or DNS resolution issues.
- Update your Clash, V2Ray, sing-box, or other client to the latest version.
- Delete the old configuration and import it again to avoid conflicts with duplicate subscriptions.
If none of these steps work, the subscription source is probably temporarily unavailable, the link has expired, or the server is restricting access. Don’t keep refreshing repeatedly; wait a while or switch to a working subscription. Keep these three things in mind when troubleshooting: whether the link is valid, whether your current network can access it, and whether it was imported correctly into the client.