Erpnext desktop workspace sidebar problem after update from v15 to v16

Workspace Sidebar Icons Not Displaying Correctly After Upgrade from v15 to v16

Hello Frappe Community,

We recently upgraded our production business system from Frappe/ERPNext v15 to v16 and have encountered an issue with the new Desktop/Workspace Sidebar configuration.

Problem

The main /desk Desktop loads correctly and displays the primary application icons normally.

However, after entering ERPNext, several standard modules/workspaces such as Accounting, Assets, Buying, CRM, Selling, Projects, Quality, Manufacturing and others do not display their normal graphical icons.

Instead, some of them appear as letter-based placeholder icons.

When interacting with the affected Desktop/Workspace Sidebar configuration, we also receive the following message:

“Icon is not correctly configured please check the workspace sidebar to it”

The modules themselves remain accessible and our existing business data appears to be intact.

Questions

Has anyone encountered this specifically after upgrading an existing v15 installation to v16?

What is the recommended method for rebuilding or refreshing the Workspace → Workspace Sidebar → Desktop Icon mapping in v16?

Would using Reset to Defaults on the affected standard Workspaces be appropriate after a v15 → v16 migration, and could this remove existing Workspace customizations?

Is there a recommended way to regenerate the v16 Workspace Sidebar configuration from the standard application definitions without affecting existing ERP data or user permissions?

We have a pre-upgrade recovery snapshot available, but we would prefer to resolve the Workspace configuration correctly rather than manually modifying standard records.

Any guidance from administrators or developers who have handled this during a v15 → v16 migration would be greatly appreciated.

Thank you.

Hi @Dixon

Can you tell us which v16 you are using as this is supposed to be bug free now. Unless it is still in process

Please @sohamkulkarni can you confirm my understanding

Thanks

Hi,

Thank you for your response.

We are currently running:

Frappe Framework: v16.33.0
ERPNext: v16.34.1
Frappe HR: v16.17.1
Payments: v0.0.1 (version-15)

This is an existing production environment that was upgraded from v15 to v16 rather than a fresh v16 installation.

The Workspace Sidebar/icon issue remains reproducible on these versions.

The main Desktop displays correctly, but after entering ERPNext, several migrated standard Workspaces display letter placeholders and produce the Workspace Sidebar icon configuration warning.

Our hosting provider has already verified that the Workspace records and icon configuration are present in the database and no separate failed Workspace migration process was identified in the logs.

Please let me know if any additional information or screenshots would be useful.

@asieftejani this is still in develop. Not releasable yet still fixing bugs. Stay tuned

3 Likes

Thanks for the clarification, @sohamkulkarni.

Understood. We will keep our current configuration unchanged and avoid applying manual workarounds while the Desktop/Workspace Sidebar functionality is still under development.

I’ll continue following the v16 updates and this discussion for any fixes or further guidance.

Thanks for confirming.