KB: Release Fails When ERC Validation Settings Differ from Project Options

Altium Designer Altium Designer
If a project release fails due to an Electrical Rule Check (ERC) violation even though the violation is set to No Report in Project Options, the ERC Validation report may be using different error reporting settings. During the release process, Altium Designer evaluates the error reporting configuration defined in the Electrical Rule Check Validation report rather than the project-level settings. Updating the ERC Validation report to use the project defaults, or manually aligning its error reporting levels with your release requirements, resolves this issue.

At a Glance

If a project release fails due to an Electrical Rule Check (ERC) violation even though the violation is set to No Report in Project Options, the ERC Validation report may be using different error reporting settings. During the release process, Altium Designer evaluates the error reporting configuration defined in the Electrical Rule Check Validation report rather than the project-level settings. Updating the ERC Validation report to use the project defaults, or manually aligning its error reporting levels with your release requirements, resolves this issue.
Go Deeper with AI:

Solution Details

Release Stops Despite No Report Setting

The Project Releaser fails with an error even though the error reporting mode for the reported violation is set to No Report in the project's error reporting settings. Users may expect the violation to be ignored during release, but the release process still reports an error and does not complete successfully.

ERC Validation Configuration Takes Precedence

Altium Designer maintains separate error reporting configurations for Project Options and validation reports. The settings used by the Electrical Rule Check Validation report are stored in the Output Job file and are independent of the project-level configuration. During a release, the Project Releaser uses the settings defined in the ERC Validation report. If those settings are stricter than the project settings, the release can fail even when the violation is configured as No Report in Project Options. This behavior is expected.

Align Validation and Project Settings

  • Configure the ERC Validation report to use the project default settings.
  • Alternatively, manually adjust the ERC Validation report error reporting levels to match your release requirements.
  • Review the ERC Validation report configuration whenever error reporting settings are changed in Project Options, as the configurations are maintained separately.

Update the ERC Validation Report

  1. Open the Validation Output Job file.
  2. In the Validation Outputs section, locate Electrical Rule Check Validation.
  3. Right-click the report and select Configure.
  4. Open the Error Reporting Mode tab.
  5. Select Set to Project Default.
  6. Select OK to save the changes.
  7. Run the Project Releaser again.
  8. Confirm that the release completes successfully.

Altium Designer Output Job view with Electrical Rules Check Setup open. Validation Outputs is selected, showing ERC rule severities. Instruction indicates resetting ERC settings to match Project Options using “Set To Project Default.” 

References

Preparing an Electrical Rules Check Validation Report

If you find an issue, select the text/image and pressCtrl + Enterto send us your feedback.