# SharedPreferences.OnSharedPreferenceChangeListener

Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  

# SharedPreferences.OnSharedPreferenceChangeListener

*** ** * ** ***

[Kotlin](https://developer.android.com/reference/kotlin/android/content/SharedPreferences.OnSharedPreferenceChangeListener "View this page in Kotlin")\|Java

`
public
static


interface
SharedPreferences.OnSharedPreferenceChangeListener
`  
`


`

|--------------------------------------------------------------------|
| android.content.SharedPreferences.OnSharedPreferenceChangeListener |

<br />

*** ** * ** ***

Interface definition for a callback to be invoked when a shared preference is changed.

## Summary

|                                                                                                                                                                                                                                              ### Public methods                                                                                                                                                                                                                                               ||
|------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| ` abstract void` | ` `[onSharedPreferenceChanged](https://developer.android.com/reference/android/content/SharedPreferences.OnSharedPreferenceChangeListener#onSharedPreferenceChanged(android.content.SharedPreferences,%20java.lang.String))`(`[SharedPreferences](https://developer.android.com/reference/android/content/SharedPreferences)` sharedPreferences, `[String](https://developer.android.com/reference/java/lang/String)` key) ` Called when a shared preference is changed, added, or removed. |

## Public methods

### onSharedPreferenceChanged

Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  

```
public abstract void onSharedPreferenceChanged (SharedPreferences sharedPreferences, 
                String key)
```

Called when a shared preference is changed, added, or removed. This may be called even if a preference is set to its existing value.

This callback will be run on your main thread.

*Note: This callback will not be triggered when preferences are cleared via[Editor.clear()](https://developer.android.com/reference/android/content/SharedPreferences.Editor#clear()), unless targeting[Build.VERSION_CODES.R](https://developer.android.com/reference/android/os/Build.VERSION_CODES#R)on devices running OS versions[Android R](https://developer.android.com/reference/android/os/Build.VERSION_CODES#R)or later.*

<br />

|                                                                                                                                                                                                Parameters                                                                                                                                                                                                ||
|---------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `sharedPreferences` | `SharedPreferences`: The[SharedPreferences](https://developer.android.com/reference/android/content/SharedPreferences)that received the change. <br />                                                                                                                                                                                                                              |
| `key`               | `String`: The key of the preference that was changed, added, or removed. Apps targeting[Build.VERSION_CODES.R](https://developer.android.com/reference/android/os/Build.VERSION_CODES#R)on devices running OS versions[Android R](https://developer.android.com/reference/android/os/Build.VERSION_CODES#R)or later, will receive a`null`value when preferences are cleared. <br /> |