Health Check Error: Custom Help File Has Name Conflict

Overview

The Health Check wizard must be run when upgrading in order to evaluate whether your instance is suitable for upgrade. During the health check, various types of issues may be detected which can affect your ability to upgrade. This article will cover the "Custom Help File Has Name Conflict" error reported by the health check.

Symptoms

This error generates an output similar to the following in health check:

Resolution

The new Emails implementation in Sugar 7.10 and above includes additional help files. Any existing custom help files that were created to customize previous versions of Sugar's Emails module cannot use the same names as these new stock files. The custom file should either be removed or renamed, but this error will not prevent the upgrade from proceeding. In this example, the emails_record_post_help.html file along with any references to the file can be renamed to custom_emails_record_post_help.html.