Keep each subscription source as a separate entry. Update the existing entry instead of adding it again. This guide covers Shadowrocket on iPhone and iPad for users who already have a subscription from their own provider. Name entries by source, organize their order in Home, compare connection settings to identify duplicates, and remove unnecessary entries. The same organizational principles apply on other platforms; gestures and menus vary by platform.
1. Understand the Difference Between Subscription Entries, Nodes, and Config
A subscription entry stores the URL used to retrieve a list of nodes. Nodes are the individual connection profiles in that list, while Config holds settings such as rules. These are separate items: deleting a node does not cancel its subscription, and reordering the Home list does not change the rule order in Config.
This site does not provide, sell, or recommend nodes or subscriptions. The steps below assume you already have a provider and subscription of your own. Before organizing your list, make sure you can still access the original details so you can recover them without relying on leftover local records.
- Subscription groups: Help identify which subscription a node came from. They are not the policy groups in Config used for rule-based routing.
- Display names: Make entries easier to recognize, but do not uniquely identify a node. Two nodes with the same name may use different servers or ports.
- Update results: Depend on the content returned by the subscription. A node deleted locally may reappear the next time you update.
2. Add and Name Subscriptions by Source to Avoid Duplicates
First check Home for an existing entry from the same source. If your provider resends the same link, you usually do not need to add another entry. If only the access token has changed, edit the URL in the existing subscription and update it. Subscription URLs may contain authorization details; do not include the full URL in a group name, screenshot, or public support request.
-
Check the Existing List
Open Home, expand your existing subscription groups, and check their source names. To verify an address, open that subscription’s edit screen and view its URL on your device. Do not rely on node names alone to identify duplicates.
-
Add a Missing Source
Only if the source is not already listed, go to Home → “+” in the upper-right corner → Type → Subscribe, then paste your own subscription link into URL. Add the subscription entry only; do not import its nodes individually as well.
-
Enter a Recognizable Name
Enter a helpful name in Remarks, such as “Personal - Main” or “Personal - Backup.” Use the name to describe its purpose, not its token or login details. Avoid using the node count as a label, since it can change over time.
-
Save and Update
After saving, return to Home and pull down to refresh the list. When organizing subscriptions for the first time, check each update result before moving on, making sure each set of nodes appears under the correct source.
-
Record the Details
In a secure personal record, note the relationship between display name, source, and purpose. Treat the full subscription URL as sensitive information; do not put it in public documents or site files.
3. Group and Reorder Subscriptions in Home
Name your subscriptions before adjusting their order. A source name tells you where the nodes came from; list order determines what you see first. Neither guarantees that the fastest node will be selected automatically. Latency tests show response time at the time of testing, not sustained throughput.
- View by source: Expand your main subscription in Home and collapse groups you are not using. Avoid renaming nodes from different sources to the same name, or it may be difficult to track them after an update.
- Reorder manually: Enter edit mode in Home and drag items that show a reorder handle. Exit edit mode when you are done. Group headings and the nodes within a group are at different levels; items without a handle cannot be moved this way.
- Check automatic sorting: If automatic sorting is enabled, check its current criteria. Sorting by name or latency can change item positions after a refresh or new test, so do not expect a manually arranged order to stay fixed at the same time.
- Check the selected connection: After organizing the list, check which node is selected. Moving an item does not switch connections; select the node you actually want to use.
The order of nodes returned by a subscription may change when the provider updates its list, so a one-time local reorder is not permanent. If the order changes after an update, check whether sorting is enabled and compare the list returned by the source. Do not repeatedly re-add a subscription to try to restore the order.
Name and Group by Source
RecommendedKeep each subscription’s source separate so you can identify which entry failed to update and remove an entire source when it is no longer in use.
Best for: Managing subscriptions over time and tracking update results
Manual Display Order
In edit mode, use the reorder handles to move eligible items and put frequently used ones first. Check the order again after updating.
Best for: Smaller lists and relatively consistent usage
Sort by Latency
Run Connectivity Test, then use the results to choose a node. Changes in latency do not mean the subscription contains duplicate entries.
Best for: Checking availability or comparing response times on your current network
Bottom line: Keep sources separate
When organizing multiple subscriptions, first confirm their names and sources, then adjust the order. Do not lose track of a node’s source just to create one uniform list.
4. Remove Duplicate Nodes: Compare Connection Settings Before Deleting
Duplicates can mean that the same subscription was added twice, or that different subscriptions returned the same node. In the first case, remove the extra subscription entry; in the second, compare the connection settings first. Removing duplicates by display name alone may delete profiles with different connection settings. Deduplicating by server address alone may treat different ports on the same server as identical.
| What You See | What to Check | How to Handle It |
|---|---|---|
| Two groups contain nearly identical lists | Original subscription URL, source, and purpose | Once you confirm they are from the same source, keep one active entry and remove the extra one |
| Two nodes have the same name | Type, server, Port, authentication parameters, and transport settings | Keep both if their settings differ; do not merge based on name alone |
| Same server, different ports | For example, ports 443 and 8443 on the same host | Treat them as separate connection profiles and check their purpose and availability individually |
| A node reappears after manual deletion | The original list returned by the subscription update | Resolve duplicate sources or check the list at its source; local deletion is not a permanent filter |
When comparing nodes, account for protocol-specific settings: the encryption method for Shadowsocks; the user ID for VMess / VLESS; the password for Trojan; and the server name and transport path for TLS can all affect the connection. WireGuard also uses settings such as keys and addresses. Check these details on your device only; do not copy them into a public support request.
- Duplicate subscription entries: If both entries point to the same source, update the one you plan to keep, then delete the other.
- Duplicates across sources: Different sources may maintain the same profile. If you keep both sources, seeing the same node more than once does not necessarily mean the update failed.
- Manually added copies: Nodes imported individually may coexist with subscription nodes. Compare their settings and purpose before removing any manual copies you no longer need.
- What update settings do: “Update via Proxy” is not a deduplication switch. It changes the network route used to retrieve a subscription; it does not merge nodes.
5. Remove Expired Subscriptions and Check After Updating
A single timeout does not prove that a subscription has expired. A network issue, expired authorization, incomplete URL, or temporary problem at the source can all cause a refresh to fail. Check the source before deleting the entry. A smaller node count after an update alone does not prove that anything was removed by mistake.
- Confirm what you are deleting: Find the subscription entry in Home, rather than selecting a node inside its group. Deleting an entry and deleting an individual node affect different things.
- Check dependencies first: If a policy group in Config refers to a node from this source by name, prepare an alternative before deleting the subscription. After removal, a reference to the same name may no longer point to the original node.
- Remove the extra entry: In Home, swipe left on the target item and tap Delete. Check its name again before proceeding. If the item shown is a node inside a group, this removes only that node—not the entire source.
- Refresh the entries you are keeping: Return to Home and update the subscriptions you still use. Check for an empty list, duplicate sources, or a change in the selected node.
- Test the connection again: Select a node you are keeping, run Connectivity Test, then check access to the services you need. Do not rely on the number of items in the list alone.
6. Troubleshoot Failed Updates, Returning Duplicates, and Reordering
A subscription keeps timing out. Should I add it again?
Do not add another entry yet. Check that the URL in the existing entry is complete, then confirm that your current network can reach the source. If direct access is blocked and you already have a working proxy connection, enable Update via Proxy under Settings → Subscribe, then refresh from Home. This setting requires a working proxy route and cannot fix an expired token.
Why did a node reappear after I deleted it and updated?
First check which group it belongs to. If the subscription still returns that node, it will reappear after an update as part of the source’s list. If it is in another group, it may be a duplicate across sources. Resolve the extra subscription entry or the list at its source instead of repeatedly deleting the same local node.
The list looks neater after sorting. Why has the connection not changed?
Display order does not determine routing. Return to Home and check the selected node and Global Routing. Config handles traffic according to its current settings; Proxy and Direct have different purposes, and Scene follows its configured behavior. Moving items in the list does not change the routing mode.
A subscription node connects, but why do some requests still fail?
Keep a backup of your current Config, then check the matching rules and policy. DOMAIN-SUFFIX, IP-CIDR, GEOIP, and FINAL affect routing decisions, not deduplication in the Home list. Troubleshoot subscription updates separately from rule-based routing, and avoid changing multiple settings at once.
7. Maintenance Checklist
For ongoing maintenance, edit the existing entry and check the update results. Do not treat On Demand as a subscription update feature: Settings → On Demand manages conditions for on-demand connections, not subscription groups, sorting, or node deduplication. Automatic connections and automatic subscription retrieval are separate functions.
- Before adding a source, check Home for an existing entry with the same subscription.
- If a URL or authorization changes, edit the existing entry instead of creating another one.
- After updating, confirm that your main node is still available and select it again if needed.
- For entries with the same name, compare Type, server, Port, and transport settings first.
- Before removing a source, check for references in Config; afterward, verify that the services you need are reachable.
- When sharing troubleshooting details, hide tokens, authentication parameters, and personal information in URLs.
Shadowrocket Downloads for All Platforms and Getting Started
Shadowrocket for iPhone and iPad costs a one-time $2.99 on the App Store. The developer is Shadow Launch Technology Limited; see the App Store listing for system requirements. The Mac (Apple Silicon / Intel), Windows, Android, and Linux versions are free. Visit the all-platform downloads page for access; installers are available from this site’s download page. Once you have a subscription of your own, follow the guide to import it and check your connection.