Reset Preferences

Add a preference reset button to user settings

Compatible with Flarum v1.6.2

Latest release 1.0.0


released on Jun 9, 2022


Reset User Preferences

MIT license Latest Stable Version Total Downloads Donate

This extension allows users to reset all their preferences to the default value at once. This includes all notification settings which use the preference API behind the scenes. Since Flarum doesn't allow doing this natively, a new permission has been added to control access to this feature.

The reset is performed by clicking the new button at the bottom of the preferences page and confirming the prompt that appears.

Most extensions should play nice with this feature but there's a small risk some extensions freak out when the preferences are reset. Flarum doesn't have any preference change event natively, so this extension is not dispatching any either.

This extension could have unexpected side effects if some extensions use the preferences API to store hidden user state as preference. Those hidden values would be reset as well when the feature is used (example: UI language).

The extension will bypass features like fof/default-user-preferences because those extensions rely on hard-coding preference values during registration rather than changing the real underlying default.

Preferences stored as user attributes are not impacted (Byobu Block private discussions, Blomstra Digest frequency, etc).


composer require clarkwinkelmann/flarum-ext-reset-preferences


This extension is under minimal maintenance.

It was developed for a client and released as open-source for the benefit of the community. I might publish simple bugfixes or compatibility updates for free.

You can contact me to sponsor additional features or updates.

Support is offered on a "best effort" basis through the Flarum community thread.


© 2022 Hyn by DaniĆ«l "Luceos" Klabbers. All rights reserved. · Extensions and extension information is provided by the respective (copyright holding) authors. · Extiverse is not affiliated to the Flarum project or Flarum foundation. · Images on Extiverse pages are from Unsplash.