Server Preferences

When managing a server, there are many different preferences you can set from the Settings section within the Plex Web app. This API command will return all the available preferences and information about each preference such as the current value.


GET http://[IP address]:32400/:/prefs?X-Plex-Token=[PlexToken]


IP addressThe IP address of the Plex Media server.
PlexTokenThe temporary authentication Plex token.

Return Status

HTTP CodeDescription
200Success - The request was successful.
401Unauthorized - The Plex token provided was not valid.


XML string value that lists the preferences that are available in the Plex server. An example of the XML returned from the request is shown below:

<?xml version="1.0" encoding="UTF-8"?>
<MediaContainer size="168">
    <Setting id="FriendlyName" label="Friendly name" summary="This name will be used to identify this media server to other computers on your network. If you leave it blank, your computer's name will be used instead." type="text" default="" value="PlexServer" hidden="0" advanced="0" group="general" />
    <Setting id="sendCrashReports" label="Send crash reports to Plex" summary="This helps us improve your experience." type="bool" default="1" value="0" hidden="0" advanced="0" group="general" />
    <Setting id="CrashUploadRetries" label="" summary="" type="bool" default="0" value="0" hidden="0" advanced="0" group="" />
    <Setting id="FSEventLibraryUpdatesEnabled" label="Scan my library automatically" summary="Your library will be updated automatically when changes to library folders are detected." type="bool" default="0" value="0" hidden="0" advanced="0" group="library" />


The XML returned provides a list of the preferences available on the Plex server. The root is the MediaContainer element. This element contains one attribute that provide a count of the preferences available on the server.

MediaContainer Attributes for Plex Devices
sizeThe number of preferences available on the Plex server.

Within the MediaContainer there are one or more Setting child elements. Each Setting element represents one preference on the Plex server.

Setting Attributes
idThe unique string value used to identify the preference.
labelThe label shown in the Plex Web app for the preference.
summaryA descriptive summary of the preference.
typeThe value type associated with the preference.
defaultThe default value for the preference.
valueThe current value of the preference.
hiddenIndicates if the preference is hidden.
advancedIndicates the preference is shown when the "Show Advanced" button is clicked in the Plex settings.
groupThe name of the Plex settings group where the preference can be found.
enumValuesThe valid values for the preference in a key/value pair list.


Example 1

Get the list of preferences and their information from the Plex Media Server located at the IP address of