calibre Tag Browser Not Updating: How to Fix It

You edit an author, tag, series, publisher, or custom column in calibre, save the change, and then notice that the Tag browser still shows the old value or does not list the new one. This usually does not mean that the book metadata failed to save. More often, the Tag browser is displaying a restricted, hidden, collapsed, sorted, or temporarily stale view of metadata that is already correct in the library database.

The safest approach is to verify one edited book, remove display restrictions, and test the simplest refresh methods before changing plugins, rebuilding the library database, or reinstalling calibre. The steps below apply to Windows, macOS, and Linux and focus specifically on the Tag browser display rather than metadata embedded inside EPUB, AZW3, PDF, or other book files.

1. Confirm the Symptom With a Small Safe Test

Before changing calibre settings, determine whether the metadata is missing or only absent from the Tag browser. Use one book and a temporary value that will be easy to recognize.

1.1 Edit one book with a unique test value

1. Select one book in the library view.
2. Open Edit metadata.
3. Add a distinctive tag such as TagBrowserRefreshTest.
4. Click OK and allow the dialog to close.
5. Select the same book and inspect its metadata in the Book details panel or reopen Edit metadata.

If the test tag appears in the book's saved metadata, the edit succeeded. The problem is now limited to how the Tag browser is displaying or filtering categories. Do not repeat the metadata edit, reconvert the book, or download metadata again.

If the value is missing when you reopen Edit metadata, investigate the editing workflow, library permissions, or a plugin that modifies metadata. That is a metadata-saving problem rather than a Tag browser refresh problem.

1.2 Check that the edit applies to the expected book

Search results, duplicate titles, and similarly named editions can make it easy to inspect a different record. After saving, keep the edited book selected and verify its title, authors, formats, and library location in the Book details panel. If necessary, open Edit metadata again from that selected row.

Success means the exact edited record contains the new value. Once that is confirmed, stop editing the book and work through the display checks below.

2. Refresh the Tag Browser After Metadata Edits

Ordinary individual metadata edits should normally be reflected in the interface without manual intervention. However, a refresh or restart can identify a temporary interface-state problem.

2.1 Clear active Tag browser selections

Clicking an author, tag, series, or another item in the Tag browser creates a search expression. Additional clicks can change the selection from matching to excluding, and clicks made while holding Ctrl or Shift can combine several restrictions.

Clear the main search bar and remove any colored selection indicators beside Tag browser items. Then collapse and reopen the relevant category. Look for the new value again.

Success means the category appears after the active search is cleared. If it does, the browser was updating correctly, but a search restriction was hiding the book or category. No repair is required.

2.2 Restart calibre as a diagnostic

Close calibre normally and open it again. A restart reloads the graphical interface and the current library database, making it a useful diagnostic step after a large edit or an unusual interface problem.

If the missing value appears after the restart and continues updating during later edits, stop troubleshooting. A one-time stale view does not justify reinstalling calibre or rebuilding the database.

If every new edit requires a restart, continue to the restriction, custom-column, plugin, and library-location checks. Repeatedly restarting is a workaround, not the final fix.

2.3 Allow bulk metadata work to finish

Bulk metadata changes can involve many selected records, search-and-replace rules, or downloaded metadata. Wait for the operation to complete and check the jobs indicator before deciding that the Tag browser is outdated. Avoid launching another bulk edit while the first operation is still being processed.

After completion, select one changed book and verify its saved metadata. Then clear searches and reopen the relevant category. Success means the expected value appears and its book count reflects the edited records.

3. Check Hidden, Collapsed, and Sorted Categories

The Tag browser can hide categories, organize values into hierarchies, and sort them in ways that make a new value difficult to find. These display choices are among the most common causes of an apparently missing category.

3.1 Restore a hidden category or value

Right-clicking Tag browser items provides management options, including options related to hiding or organizing categories. Open the Tag browser configuration menu and review which categories are displayed. Restore Authors, Tags, Series, Publishers, or the affected custom column if it has been hidden.

Also check whether an option that hides empty categories is enabled. That option can be useful, but it can complicate diagnosis while another search or find operation is active.

Success means the missing top-level category returns and can be expanded. Once it is visible, do not change unrelated interface settings.

3.2 Expand hierarchical and partitioned values

Tags, series, and compatible custom columns can be presented as hierarchies. A value such as Fiction.Mystery might appear under a collapsed Fiction branch rather than as one flat entry. Large categories can also be divided into smaller alphabetical groups.

Expand the triangles beside parent items and alphabetical partitions. If hierarchical display is enabled, make sure the Tag browser is sorted by name, because hierarchical display depends on name sorting.

Success means the value is present under its parent or partition. In that case, the metadata and refresh behavior are correct.

3.3 Use the Tag browser find function

Use the find or search control at the bottom of the Tag browser and enter part of the new value. This is faster and more reliable than manually scanning a long author or tag list.

If find locates the value, the browser has updated. The apparent problem is its location, hierarchy, sort order, or collapsed state. Clear the find text afterward so it does not continue hiding unrelated entries.

4. Check Author Names Versus Author Sort Values

calibre stores both an author name and author sorting information. For example, a book can display the author as Jane Smith while using a sort value such as Smith, Jane. Depending on calibre's advanced tweak settings, the Tag browser can display author names or author sort values.

4.1 Inspect the book's author and author sort fields

Open Edit metadata for the test book and compare Authors with Author sort. Then use the author management dialog available through the Tag browser to inspect the stored sort value for that author.

If you edited the author name but are searching for the new name in a browser configured around sort values, the entry may be listed somewhere unexpected. Likewise, a changed sort value can move an existing author without changing the displayed author name.

4.2 Review the author display tweak only if necessary

Advanced users can check the author category display tweak under Preferences, Advanced, and Tweaks. The relevant configuration determines whether author categories use the author name or the author sort value.

Do not alter this setting merely to force a refresh. Change it only if the current presentation is not the one you want. Restart calibre if the preference indicates that a restart is required.

Success means the author appears under the expected name or sort position. Once you understand which field is being displayed, stop changing metadata.

5. Remove Search Restrictions and Virtual Library Filters

A normal search restricts the book list, but a Virtual library also restricts the values shown in the Tag browser. This distinction is critical when a newly added author, publisher, series, or tag appears to be missing.

5.1 Return to the full library

Open the Virtual library selector and choose the unrestricted option, commonly shown as None. Also remove any additional restriction or temporary Virtual library based on the current search.

Virtual libraries behave as though only their matching books exist. If the edited book does not belong to the selected Virtual library, its metadata values will not appear in the Tag browser even though they are safely stored in the main library.

Success means the value appears after returning to the full library. If so, the correct fix is to change the Virtual library definition when appropriate, not to edit or recreate the book.

5.2 Clear the main search separately

A regular search and a Virtual library can be active at the same time. Clear the search bar, remove Tag browser selections, and verify that no additional restriction remains.

If the book row becomes visible but the category still does not, confirm that you have completely left the Virtual library. A simple search normally limits the book list, while the Virtual library controls which category values the Tag browser offers.

6. Verify Custom Column Category Settings

Not every custom column is designed to appear in the Tag browser. A value can save correctly in a custom column while never becoming a browsable category.

6.1 Confirm that the column type supports the Tag browser

Open the custom-column settings under Preferences and inspect the affected column. A genre-like field intended to behave like tags should use an appropriate column type, such as comma-separated text configured for display in the Tag browser.

If the column was created as ordinary text, comments, a numeric value, or another unsuitable type, changing a book's value will not necessarily create the category behavior you expected. Do not delete and recreate the column until you have backed up or copied any important values.

Success means the custom column is listed as a category and the test value appears beneath it. If the column type is wrong, plan a controlled migration rather than making repeated edits to books.

6.2 Check the custom column lookup name

Custom columns have a visible heading and an internal lookup name that usually begins with a number sign. Make sure you are editing, searching, and configuring the same column. Libraries with several similarly named fields can make this surprisingly easy to miss.

6.3 Check hierarchy configuration

If the custom value contains periods, calibre may display it as a hierarchy when the column has been configured for hierarchical items. For example, History.Military can appear as Military beneath a collapsed History branch.

Expand the parent branch and set the Tag browser to sort by name. Success means the value appears in its hierarchical position, proving that the update was successful.

7. Separate Library Metadata From Files, Devices, and Servers

The desktop Tag browser is built from the active calibre library's database. It is not normally refreshed from metadata embedded inside an e-book file, a connected reader, the E-book viewer, or the Content server.

7.1 Conversion is usually unrelated

Converting a book can write selected metadata into an output format, but conversion is not required to make library metadata appear in the desktop Tag browser. Do not reconvert a book solely because a new tag or author is missing from the browser.

Similarly, editing a book's internal files in the E-book editor does not automatically mean that the library database's author, tag, publisher, or series fields have changed. Verify the value in the main calibre Edit metadata dialog.

7.2 Device metadata is a separate view

When a reader is connected, calibre can show a device collection instead of the computer library. Confirm that the main view is displaying Library, not the device's main memory or storage card.

A device may organize authors and collections according to its own firmware, transfer settings, plugboards, or supported metadata fields. USB mode and device detection matter when books cannot be transferred or the device view is wrong, but they do not normally control the desktop library's Tag browser.

Success means the new category appears when the computer library is selected. If it is missing only on the reader, investigate device metadata and collection support as a separate issue.

7.3 Content server changes do not replace desktop verification

If the problem appears in a web browser connected to the calibre Content server, first verify the same book and category in the desktop application. Confirm that the server is exposing the intended library and that the signed-in account is not limited by a library restriction or search expression.

Restarting the Content server may be relevant to a server-only display problem. Firewall and network settings matter when the server cannot be reached, but they do not explain a missing category in the local desktop Tag browser.

8. Check the Active Library and Its Storage Location

calibre can manage multiple libraries. It is possible to edit a book in one library, switch libraries, and then search for the value in another. Use the library selector to verify the name and path of the active library.

8.1 Avoid live libraries on unsupported synchronized storage

The calibre documentation advises against placing an active library on a network drive or NAS because file locking and other filesystem behavior can be unreliable. Cloud synchronization can also cause conflicts if a syncing application modifies library files while calibre is running or if the same library is opened on two computers.

For a diagnostic test, close calibre, allow synchronization to finish, and copy the library to a normal local folder with adequate free space and permissions. Open the copied library through calibre's switch or create library function. Do not manually open or edit metadata.db.

Success means edits immediately appear in the local test library's Tag browser. If so, the original storage arrangement is the likely cause. Stop changing calibre display settings and address the storage workflow.

8.2 Check operating system access

The user account running calibre needs reliable read and write access to the library folder and configuration location. Security software, controlled-folder protection, restrictive permissions, read-only mounts, or a disconnected external drive can interfere with normal library operations.

Permission problems usually produce broader symptoms than one missing Tag browser value, so investigate them only if edits fail to persist, errors appear, or the library behaves inconsistently. Do not disable antivirus protection globally. If security software reports an action, review the alert and use a narrow, trusted exception only when justified.

9. Isolate Plugins and Gather Useful Diagnostics

Most Tag browser display problems are solved by clearing restrictions or correcting category settings. Use diagnostics when the same one-book test fails repeatedly or the interface behaves differently after installing or updating a custom plugin.

9.1 Test without custom plugins

Close calibre completely, including any tray instance. Start it from a terminal or command prompt with the option that ignores custom plugins:

calibre --ignore-plugins

Repeat the one-book test in the same library without performing bulk operations. If the Tag browser updates normally, re-enable normal startup and disable recently added or category-related custom plugins one at a time.

Success means you can identify one plugin whose absence restores normal behavior. Stop once the responsible plugin is isolated, then update it, review its support information, or leave it disabled.

9.2 Start the graphical interface from calibre-debug

For a repeatable failure, close calibre and start the graphical interface from a terminal with:

calibre-debug -g

Perform the smallest possible test and watch for error output when saving metadata or refreshing the interface. Copy the diagnostic text before closing the terminal if you need to request support.

Conversion debug output, device-detection logs, and viewer or editor logs are useful only when the failure involves those components. They usually add noise when the only symptom is the local Tag browser failing to reflect saved library metadata.

9.3 Use library maintenance cautiously

Open calibre's Library maintenance tools and run the library check if you also see missing formats, malformed paths, unexplained records, or other consistency problems. A database restoration is not a routine refresh procedure.

Restoring the database rebuilds it from per-book metadata backups and can affect library-specific information. Use it only when there is evidence that the database is damaged, after making a verified backup, and after simpler display tests have failed.

10. Run a Clean Temporary Test Before Reinstalling

Reinstalling calibre usually leaves the library and configuration in place, so it often does not fix a restriction, hidden category, plugin conflict, or damaged configuration. A temporary library gives you much better evidence.

1. Create a new empty library in a normal local folder.
2. Add one DRM-free test book or a disposable document you are permitted to use.
3. Edit its author and add a unique tag.
4. Save the metadata and inspect the Tag browser.
5. Repeat the test without custom plugins if necessary.

If the temporary library updates correctly, the calibre installation and basic interface are working. The cause is probably limited to the original library, its location, its restrictions, or its custom-column configuration.

If the clean library also fails, test with a fresh configuration or collect debug output before reinstalling. Do not delete the original library, configuration folder, or metadata.db as an experiment.

11. Quick Fix Checklist

• Verify the new value by reopening Edit metadata for one selected book.
• Clear the main search bar and all active Tag browser selections.
• Switch from any Virtual library back to the full library.
• Remove additional restrictions based on saved searches.
• Restore hidden categories and clear the Tag browser find box.
• Expand hierarchical values and alphabetical partitions.
• Check whether authors are displayed by name or author sort value.
• Confirm that the custom column type can appear in the Tag browser.
• Wait for bulk metadata operations and jobs to finish.
• Restart calibre once as a diagnostic refresh.
• Confirm that you are viewing the computer library rather than a device.
• Test without custom plugins if the problem persists.
• Use a small local temporary library before reinstalling or restoring a database.

12. Frequently Asked Questions

12.1 Why does the book show the new tag while the Tag browser does not?

The Tag browser may be restricted by a Virtual library, additional restriction, hidden category, active find operation, or collapsed hierarchy. If the selected book's Edit metadata dialog contains the new tag, the edit has saved. Focus on the browser's display state rather than editing the book again.

12.2 Do I need to refresh calibre after every metadata edit?

No. Normal edits should appear without repeatedly restarting the program. Clear searches and reopen the category first. A single restart is useful for diagnosis, but needing a restart after every edit suggests a persistent interface, plugin, storage, or configuration problem.

12.3 Why is a new author listed under an unexpected letter?

The author can be positioned according to an author sort value such as Family Name, Given Name. calibre can also be configured to display author category entries using names or sort values. Check both fields before concluding that the author is missing.

12.4 Why does a custom column value not appear?

The custom column must use a type that supports display in the Tag browser. It may also be hidden or configured as a hierarchy. Confirm the column type, lookup name, category visibility, and hierarchy settings.

12.5 Can a Virtual library hide new categories?

Yes. The Tag browser shows only category values belonging to books in the active Virtual library. Return to the unrestricted full library. If the value appears, calibre is working as designed.

12.6 Should I restore the database or reinstall calibre?

Not as a first response. First verify one book, clear restrictions, check category visibility, test custom plugins, and create a temporary local library. Restore the database only when there is credible evidence of corruption and you have a backup. Reinstall only after a clean test indicates an application-level problem.

The most important stopping rule is simple: once the edited value appears in the correct category and remains visible after clearing restrictions or restarting, stop changing settings. Additional repairs can create new problems without improving a Tag browser that is already working.