Option Revisions
Last updated: April 5, 2022
Only super-admins can see the Option Revisions page. Clients cannot access this page or data.
The Option Revisions page holds data collected about changes made to site-wide settings and options. This can tell you who made an update, when it happened, what page the update happened on, which fields were affected, and what the values of the fields were before and after the update. We hope you can use this to revert changes that shouldn’t have been made or more easily find settings that might be causing site-wide issues.
If you have ideas about how we can make the revisions log better please submit ideas to the FH.ME idea box!
Revision Groups
Field revisions are grouped by time and user, so if multiple fields are updated with one click of the ‘update’ button, they will be grouped together.
In the Revisions Log on the Option Revisions, on load, only data for each revision group will show. Click on a revision group to drop down and see the revision data associated with each field in the revision group.
Additionally, only the 20 most recent revision groups will show on load. Click ‘Show More’ to see earlier revisions.
Filtering the Revisions Log
The revisions log can be filtered by user, date, page, and field. So for example, if you want to reference a change you made to fonts last week, you can select your username from the dropdown, select a start and end date around the time it would have occurred, and select ‘Look Feel’ from the Page dropdown. This should make finding that revision much easier than sifting through ALL recent updates to site settings.
Another example would be if you would like to see the full history of a particular field, you could select that field from the dropdown with no other filter and see every revision made to it since revisions began being recorded.
Interpreting Revisions
A lot of what is shown in the revision log (especially field names and values) is raw information from the database. This may make it tricky to interpret. If field names or values do not correspond to something you recognize from the wp admin, you can try inspecting a field to and referencing its id to understand how it might show in the revision log.
As an example, the expanded revision group above adds a third color to the color palette repeater field where there were only two before. The new color has the name ‘neutral’ and is assigned the hex code ‘#eaeaea.’
If you need more help interpreting the meaning of a field revision or anything else in a revision log, please use the Question Queue flow in #fhs_all to reach out to your peers and the developers for help.