Skip to content
This documentation applies to Codacy Self-hosted v4.2.0

For the latest updates and improvements, see the latest Cloud documentation instead.

Configuring code patterns#

By default, Codacy uses a subset of the code patterns that exist for each tool to analyze your repositories. These default code patterns result from community feedback or existing coding standards.

However, you can create a coding standard adapted to your scenario by configuring the tools and code patterns that Codacy uses to analyze each repository:

  1. Open your repository Code patterns page and select the tool to configure:

    Configuring code patterns

  2. Enable or disable the code patterns using the checkbox for each pattern.

    To see an explanation of the issues that a pattern detects and how to fix them, click Show details. Some patterns also allow you to configure the rules for detecting issues:

    Code pattern details

  3. Optionally, manually reanalyze your repository to immediately take the changes into account. Otherwise, Codacy will use the new configuration when it analyzes a new commit or pull request.

Tip

Organization owners can change who is allowed to configure code patterns.

Pattern filters#

To make it easier to find relevant code patterns, you can use the sidebar to filter the patterns by language (only for tools that support multiple languages), category, or status:

Filtering code patterns

Tip

To enable all code patterns matching a specific category, use the filter to select the relevant patterns and click Enable all.

For example, to enable all Security patterns of a tool, you can use the Security filter and click Enable all.

Issues detected by Codacy belong to one of the following categories:

  • Code Style: Code formatting and syntax problems, such as variable names style and enforcing the use of brackets and quotation marks
  • Error Prone: Code that may hide bugs and language keywords that should be used with caution, such as the operator == in JavaScript or Option.get in Scala
  • Code Complexity: High complexity methods and classes that should be refactored
  • Performance: Code that can have performance problems
  • Compatibility: Mainly for frontend code, compatibility problems across different browser versions
  • Unused Code: Unused variables and methods, code that can't be reached
  • Security: All security problems
  • Documentation: Methods and classes that don't have the correct comment annotations

Importing pattern configurations from another repository#

Importing tool and code pattern configurations from another repository can help you bootstrap and standardize the coding standard across your repositories.

For example, when adding a new repository on Codacy you can copy the tool and code pattern configurations from an existing repository that's already configured, and then tweak and adapt the settings for your new repository.

Tip

You can also copy the tool and code pattern configurations from one repository to multiple target repositories.

Important

Consider the following when using this feature:

  • Tool matching: Codacy only copies settings for tools that are available on both the source and target repositories, and overwrites the existing settings for these tools on the target repository.
  • Toggle status: Codacy copies the enabled or disabled status of the matching tools from the source to the target repository.
  • Configuration files: Codacy copies the UI configuration of all matching tools, even those set to use configuration files. However, the import doesn't include the configuration mode itself.

The following example illustrates the points above:

Source repository Target repository Target repository after import
Source repository Target repository Target repository after import

To import the tool and code pattern configurations from another repository:

  1. Open your repository Code patterns and click Import patterns.

    Importing code patterns from another repository

  2. Follow the instructions to select the source repository and complete the import.

  3. Review and adjust your tool and code pattern configurations if necessary.

Codacy will use the updated configurations on the next analysis.

Setting a default configuration for new repositories#

If you're adding multiple repositories to Codacy that should reuse the same pattern configuration for a tool, you can define that configuration as the default. Codacy automatically applies that default configuration to new repositories.

To apply the same code pattern configuration to multiple repositories:

  1. Add the first repository and configure the code patterns on that repository for the relevant tools.

  2. Expand the menu at the top of the pattern list and select Set default.

    This option sets the current pattern configuration of all tools as the default for your account.

    Setting a default code pattern configuration

After defining the default code pattern configuration for your account, the tools in the new repositories that you add will automatically use those configurations.

Alternatively, you can also manually apply the default code pattern configuration for your account to all tools by expanding the menu at the top of the pattern list and selecting Reset.

Using your own tool configuration files#

Codacy supports configuration files for several tools. To use a configuration file for your static analysis tool:

  1. Push the configuration file to the root of the branch configured as the main branch on Codacy.

  2. Open your repository Code patterns page, select the tool that will use the configuration file, and select the option Configuration file:

    Using a configuration file

After activating the option to use the configuration file:

  • Codacy will use the version of the configuration file in the branch being analyzed. For example, if you open a pull request that includes changes to the configuration file, the analysis results will take those changes into account.
  • If Codacy analyzes a branch that doesn't include the configuration file, Codacy reverts to using the code patterns configured for the tool before you selected the option Configuration file on the Code patterns page.

The table below lists the configuration file names that Codacy detects and supports for each tool:

Tool name Language Files detected Other info
Ameba Crystal .ameba.yml
Bandit Python bandit.yml, .bandit To solve flagged valid Python "assert" statements, create a bandit.yml in the root of the repository containing: skips: \['B101'\]
Brakeman Ruby config/brakeman.yml
Checkstyle Java checkstyle.xml Supports configuration file in directories other than root and can search up to 5 directories into the repository.
CodeNarc Groovy .codenarcrc
Credo Elixir .credo.exs, config/.credo.exs
CSSLint CSS .csslintrc
Detekt Kotlin default-detekt-config.yml, detekt.yml Supports configuration file in directories other than root and can search up to 5 directories into the repository.
ESLint JavaScript, Typescript .eslintrc.js, .eslintrc.cjs, .eslintrc.yaml, .eslintrc.yml, .eslintrc.json, .eslintrc, .prettierrc, .prettierrc.yaml, .prettierrc.yml, .prettierrc.json, prettier.config.js, .prettierrc.js Plugins in the UI
Other Plugins
Hadolint Dockerfile .hadolint.yaml
JSHint JavaScript .jshintrc
markdownlint Markdown .markdownlint.yaml, .markdownlint.jsonc, .markdownlint.json
PHP_CodeSniffer PHP phpcs.xml, phpcs.xml.dist
PHP Mess Detector PHP codesize.xml, phpmd.xml, phpmd.xml.dist
PMD Apex, Java, JavaScript, JSP, PL/SQL, XML, Velocity and Visualforce ruleset.xml, apex-ruleset.xml Supports configuration file in directories other than root and can search up to 5 directories into the repository.
Prospector Python .prospector.yml, .prospector.yaml, prospector.yml, prospector.yaml, .landscape.yml, .landscape.yaml, landscape.yml, landscape.yaml
Pylint Python pylintrc, .pylintrc Plugins
RemarkLint Markdown .remarkrc, .remarkrc.json, .remarkrc.yaml, .remarkrc.yml, .remarkrc.js
Revive Go revive.toml
Rubocop Ruby .rubocop.yml
Scalastyle Scala scalastyle-config.xml, scalastyle_config.xml
Sonar C# C# SonarLint.xml
Sonar VB Visual Basic SonarLint.xml
SpotBugs Java, Scala findbugs.xml, findbugs-includes.xml, findbugs-excludes.xml, spotbugs.xml, spotbugs-includes.xml, spotbugs-excludes.xml Supports configuration file in directories other than root and can search up to 5 directories into the repository.
Stylelint CSS, LESS, SASS .stylelintrc, stylelint.config.js, .stylelintrc.json, .stylelintrc.yaml, .stylelintrc.yml, .stylelintrc.js Supports configuration file in directories other than root and can search up to 5 directories into the repository.
SwiftLint Swift .swiftlint.yml
Tailor Swift .tailor.yml
TSLint TypeScript tslint.json
TSQLLint Transact-SQL .tsqllintrc

Note

Codacy doesn't support configuration files for the following tools:

  • Cppcheck
  • Clang-Tidy
  • deadcode
  • Checkov
  • Staticcheck
  • ShellCheck
  • SQLint
  • BundlerAudit
  • JacksonLinter
  • Codacy ScalaMeta Pro
  • Coffeelint
  • aligncheck
  • Flawfinder
  • PSScriptAnalyzer
  • Faux Pas
  • Gosec

For performance reasons, if you make changes to pattern settings using configuration files, Codacy may display outdated messages for issues that have already been identified by those patterns.

See also#

Share your feedback 📢

Did this page help you?

Thanks for the feedback! Is there anything else you'd like to tell us about this page?

We're sorry to hear that. Please let us know what we can improve:

Alternatively, you can create a more detailed issue on our GitHub repository.

Thanks for helping improve the Codacy documentation.

If you have a question or need help please contact support@codacy.com.

Last modified August 24, 2021