Running into 4010 errors or mismatched artwork and need to clear out your matched and uploaded songs? Here's how to go about doing it.

To help people sort out their Apple Music and iTunes Match libraries, I've been tackling a number of troubleshooting articles on the subject.

Resetting iCloud Music Library was next on my list, so imagine my delight when I saw that friend-of-iMore Stephen Hackett had already written a great article about this back in January on his blog, 512 Pixels. You should definitely check out Stephen's article and his process for clearing his iCloud Music Library, but I also wanted to talk a little bit here about resetting your library and why you might want to do it.

When do you need to reset your iCloud Music Library?

Are there songs from your collection that got matched to the wrong Apple Music or iTunes Match track? Wrong album art? iTunes 4010 errors? If you've run into any of these, Apple's cloud copy of your music might need to get dumped and resynchronized.

Before you go about doing this, make absolutely sure you have a hard-copy backup of your music library on at least one of your Macs: You don't want to delete your iCloud library and accidentally end up without songs you've uploaded, purchased, or matched.

How to reset your iCloud Music Library

There are currently two ways to reset your iCloud Music Library—you can either use Apple's official toggle, or manually remove your songs from iCloud. Note: Either method will get rid of any songs you downloaded from the Apple Music streaming catalog.

Option A: Use Apple's method

As detailed in this support document, you can reset your iCloud Music Library from the Account menu. Here's how to go about doing it.

  1. From the iTunes window on your Mac or PC, click on your Account banner in the upper right corner of the window and select Account Info. You may have to re-enter your Apple ID and password to view this screen.
  2. Scroll to the bottom of the screen and click Reset to reset your iCloud Music Library. (If you do not see this button—it's not showing up on some users's libraries—you'll have to use option B to reset iCloud Music Library, instead.)
  3. Apple will ask if you want to delete all the music and playlists stored in iCloud Music Library; confirm and click Reset Now. Once it's finished the reset process, close iTunes.
  4. Restart iTunes while holding the Command and Option keys. (On a PC, hold Control and Shift.)
  5. Click Restore Library from the ensuing pop-up to do a rescan of your hard drive's physical tracks.

  6. Check to make sure everything looks good in your library, then go to the iTunes menu > Preferences and click the General tab, then click on the box to re-activate iCloud Music Library.

Option B: Manually restore your music

  1. In iTunes on your Mac, go to the iTunes menu > Preferences > General, then uncheck iCloud Music Library.
  2. Quit iTunes on your Mac.
  3. Re-open iTunes and hold down the option key.
  4. In the Choose iTunes Library screen, select Create Library.

  5. Name your new iTunes Library "iCloud-Music-Library" or something equally catchy.
  6. Turn on iCloud Music Library.
  7. After a few moments of talking to iCloud, you should see your Music Library in Album view; switch to song view by clicking on the dropdown in the upper right corner.

  8. Select all your songs (Command-A on your keyboard) and press the delete key. You'll get a warning that you're deleting these all from iCloud Music Library; press Delete Items to make it happen.

Your iCloud Music Library is now empty, waiting for you to refill it. From here, you have a few choices.

If you'd like to add songs from the Apple Music catalog to your iCloud Music Library and stream them on both your iOS devices and Macs, but don't want your primary iTunes Library uploaded, it's an easy fix: Use the second iTunes Library.

Your first iTunes Library remains, with iCloud Music Library off, for you to listen to your existing collection.

In your second iTunes Library (the one named "iCloud-Music-Library" or somesuch), just make sure iCloud Music Library is turned on in iTunes > Preferences > General. (It should be, if you immediately followed the previous steps.)

From here on out, anytime you add a song to iCloud Music Library on your iPhone, it'll show up in this iTunes library.

And if there are songs you want to sync from your original library into iCloud Music Library, just copy them from your hard drive into this second library, then delete the secondary copy from iTunes.

This should keep Apple Music entirely siloed from your primary iTunes Music collection. Ideally, of course, you'd want to mix the two, but if you're running up against the 25,000 song limit or getting weird album art and matching errors, this may be the way to go.

If you're not worried about Apple Music/iTunes Match and your primary iTunes Library co-mingling, you can quit iTunes and go back to your original library, then turn iCloud Music Library back on from iTunes > Preferences > General.

Your library should automatically re-sync, but if it doesn't for whatever reason, just highlight all tracks and control-click on them, then select Make Available Offline.

Did this work? Still having problems?

Bug Apple Support and let us know in the comments.