A matching rule tells Soundiiz exactly which track, album, or artist on one music service corresponds to an item on another service. Soundiiz then uses that rule instead of its automatic matching result in future transfers and playlist synchronizations.
Create a matching rule when Soundiiz selects the wrong version of a song, cannot find an item that is available on the destination service, or should never match an item on a specific service.
How matching rules work
How to create a matching rule
- Open Matching Rules in Soundiiz.
- Select Add a matching rule.
- Choose Track, Album, or Artist.
- Select two different music services.
- Search for and select the corresponding item on each service.
- Confirm the rule.
You can also open User settings and select Matching Rules.
What can I use to find an item?
If a search returns several versions, check the artist and release details on the destination service before selecting the item.
Create or edit a rule from available results
When a track is not found during a one-time transfer, Batch, or Sync, use its detailed result while it is still available:
- For a one-time transfer, stay on the final result screen. For a Batch or Sync, open the available execution in its history.
- Select the matching-rule action next to the track that was not found.
- Search for the correct track on the destination service and select it.
If the result already used a matching rule, select its edit action to change the rule. The new or updated rule is used by future operations; it does not rerun the completed operation automatically.
Detailed results are not kept indefinitely. See Can I Recover Old Transfer, Batch, or Sync Results? for the availability period of each operation.
Prevent an item from being matched
If a track, album, or artist does not exist on a destination service, select the crossed-out This track/album/artist is not existing on [service] result.
Soundiiz will then treat that item as unavailable on that service instead of selecting another result through automatic matching.
Related guides
| Wrong Track Matches | How Playlist Sync Works |
| Synchronization History | All Soundiiz tutorials |
Frequently Asked Questions
Can I edit or delete a matching rule?
Yes. Open Matching Rules to review, edit, or delete your rules. If Soundiiz reports that a rule already exists for an item and service, edit the existing rule instead of creating a conflicting one.
What happens when I create an album matching rule?
Soundiiz first creates the album rule. When both albums contain the same number of tracks, Soundiiz pairs them in album order and creates the corresponding track matching rules. If the track counts differ, Soundiiz keeps only the album rule.
Soundiiz refused to save my rule. Why?
A rule needs both items to be identified on their own service, and both sides have to be two different services. When one of the two items carries no identifier, Soundiiz declines the rule rather than saving one that would never be applied.