Update or Refresh a Library

Once a Library has been created, it is processed by your Plex Media Server so all the media items are matched and metadata is gathered. As time goes on, you'll add and remove media to the Libraries or make other changes that mean the Library is no longer up-to-date. You can Refresh or Update Libraries to bring them up-to-date. Updating and Refreshing a Library do different things.

Update vs Refresh

Updating and refreshing a Library both have to do with getting content into the Library. They're different—but related—functions.

Update

Updating a Library makes the Server check its folders and sub-folders for new or removed media. If it finds new or unmatched media, it then scans it into the Library and fetches metadata for it. You can think of updating as "check for new or changed content and get metadata for it if needed".

You should Update a Library if you have:

  • Added or deleted media files
  • Added or removed folders from the Library source
  • Renamed a media file
  • Moved files from one location to another

Refresh

Refreshing a Library or individual item causes the metadata for the item to be refreshed, even if it already has metadata. You can think of refreshing as "update metadata for the requested item even if it already has some".

You should refresh a Library or individual item if:

  • You've changed the Library Metadata Agent
  • You've added "Local Media Assets" (such as artwork, theme music, external subtitle files, etc.)
  • You want to freshen the item posters, summary, etc.
  • There's a problem with the poster image that's been downloaded
  • Items are missing posters or other downloaded information. This is possible if the refresh process is interrupted (the Server is turned off, internet connection dies, etc).

Tip!: A "Force Refresh" is really just a specific version of a Refresh in which the refresh is applied to an entire Library.

Triggering Update and Refresh

A Library Update typically needs to happen every time you add or remove media files, and so it's useful to be automated. A Refresh is something you'll want to do less often and so it's a manual action. In many cases, Updates may be initiated for you automatically such as when you save changes to a Library's settings.

Automatic and Periodic Updates

Settings to control automatic or periodic Library updates can be found under Settings > Server > Library in Plex Web App.

Related Page: Plex Media Server > Using Plex Web App
Related Page: Plex Media Server > Server Settings > Library (Settings)

Update my library automatically

Typically, the most desirable way to keep your Libraries updated is using the Update my library automatically feature. This uses capabilities of the operating system to detect when content has changed and then initiate a Library update.

Note: In most cases, this should work for content on local filesystems. It will generally not work for network shares mounted via SMB, NFS, AFP, or similar.

If you have this option enabled and Library updates don't happen automatically (you should wait 60 seconds after all activity on the drive finishes), automatic updates may not be supported on your operating system/filesystem and you may wish to use periodic updates instead.

Update my library periodically

Periodic updates for your Library allow you to have updates run at a set frequency. This is controlled by two settings:

  1. Update my library periodically: Enable or disable whether updates are run at a set frequency
  2. Library update interval: Choose the frequency of updates

Available periodic frequencies are:

  • every 15 minutes
  • every 30 minutes
  • hourly
  • every 2 hours
  • every 6 hours
  • every 12 hours
  • daily

Note: The periodic frequency is based on when the Plex Media Server starts up. If you start your Server at 12:15 and have it set to update every 30 minutes, then an update will start around 12:45.

Updating and Refreshing Manually

You can manually Update or Refresh a Library as a whole or particular items within a Library. The options available and particular actions taken can vary depending on from where the action is initiated.

The behavior can also vary depending on whether or not the Run a partial scan when changes are detected (advanced) option is enabled.

Related Page: Plex Media Server > Server Settings > Library (Settings)

Update a Library

A standard update will:

  1. Scan for new or changed content in a Library
  2. Gather metadata for new/changed items as needed

This is initiated via the Update Library button when viewing a Library at the top right.

This action is performed on a Library as a whole.

Related Page: Plex Media Server > Libraries > Library Actions

Force Refresh a Library

Force Refreshing a Library will:

  1. Scan for new or changed content in a Library
  2. Gather new metadata for all items in a Library, including those that already have metadata

This is initiated via the Force Refresh... option under the Library actions when viewing a Library at the top right.

This action is performed on a Library as a whole.

Related Page: Plex Media Server > Libraries > Library Actions

Refresh Specific Items

It's possible to Refresh specific items. These can be individual items (a specific movie or TV episode) or containing elements such as a series for TV or artist/album for music Libraries. The specific behavior can vary depending on Library settings and from where the Refresh was initiated.

Individual Item

When performing a Refresh for an individual movie or TV episode, Plex will:

  1. Scan for new local media assets (subtitles, local artwork, etc.)
  2. Gather new metadata for the movie or episode

This can be initiated via the Refresh button in the left actionbar of the item details screen or when hovering over an item's poster.

Refresh TV Series

When performing a Refresh for a television series, Plex will:

  1. Scan for new or changed content in the directory associated with the series (if Run a partial scan when changes are detected is enabled)
  2. Gather new metadata for the series

This can be initiated via the Refresh button in the left actionbar of the series details screen or when hovering over a series's poster.

Refresh Music Artist or Album

When performing a Refresh for a music artist or album, Plex will:

  1. Gather new metadata for the artist or album

This can be initiated via the Refresh button in the left actionbar of the series details screen or when hovering over an item's poster.