mirror of
https://github.com/renovatebot/renovate.git
synced 2026-11-01 10:09:50 +00:00
Jamie Tanna
b62fe59594
We dropped the "bot" from our terminology long ago, but it looks like we've got some outdated docs + code that reference it. We should remove this to keep things consistent. A `fix`, as we're changing the commit author's name, and log lines. Co-authored-by: Claude Sonnet 5 <jamie.tanna+claude-code@mend.io> Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
72 lines
2.8 KiB
Markdown
72 lines
2.8 KiB
Markdown
---
|
|
title: Presets
|
|
description: Learn about Renovate configuration presets
|
|
---
|
|
|
|
Renovate presets are reusable bits of configuration, stored in JSON, JSON5 or JSONC format.
|
|
|
|
Presets that are included with Renovate are referenced by their name, like [`:dependencyDashboard`](../presets-default.md#dependencydashboard) and [`security:minimumReleaseAgeNpm`](../presets-security.md#securityminimumreleaseagenpm).
|
|
|
|
Custom presets are referenced by repository location.
|
|
To learn how to create and host them, read the [Shareable Config Presets](../config-presets.md) page.
|
|
|
|
## Why you should use presets
|
|
|
|
Use presets to:
|
|
|
|
- Set up Renovate with good default settings
|
|
- Avoid duplicating your configuration
|
|
- Share your configuration with others
|
|
- Use somebody else's configuration as-is, or extend it with your own rules
|
|
|
|
## How to use presets
|
|
|
|
Say you're using the `config:recommended` preset, and want to pin your GitHub Action digests.
|
|
Instead of writing your own Renovate config, you search the docs, and find the `helpers:pinGitHubActionDigests` preset.
|
|
Then you add the preset to the `"extends"` array in your Renovate configuration file:
|
|
|
|
```json
|
|
{
|
|
"extends": ["config:recommended", "helpers:pinGitHubActionDigests"]
|
|
}
|
|
```
|
|
|
|
In the example above, Renovate follows the rules from the `config:recommended` preset, plus the rules for `helpers:pinGitHubActionDigests`.
|
|
|
|
!!! tip
|
|
If there is a logical conflict between presets, then the _last_ preset in the `"extends"` array "wins".
|
|
|
|
## Managing config for many repositories
|
|
|
|
If you manage the Renovate configuration for many repositories, we recommend that you:
|
|
|
|
1. Create a global preset configuration
|
|
1. Extend from the global preset in all of the repositories that should use your global preset as base
|
|
|
|
This way, when you want to change your global Renovate configuration, you only need to edit the global preset file.
|
|
|
|
## Presets are modular
|
|
|
|
Preset configs are modular: a preset can be as small or large as you need.
|
|
A preset can even extend from _other_ presets.
|
|
|
|
## Built-in presets
|
|
|
|
Renovate comes with many built-in presets.
|
|
We recommend you browse [Renovate's default presets](../presets-default.md).
|
|
Again, to use the preset: add it to the `"extends"` array in your Renovate config file.
|
|
|
|
### Contributing a new built-in preset
|
|
|
|
If you have a Renovate config that may help others, you can put it into Renovate's built-in presets.
|
|
Read [Contributing to presets](../config-presets.md#contributing-to-presets) to learn how.
|
|
|
|
## Summary
|
|
|
|
In short:
|
|
|
|
- Browse [Renovate's default presets](../presets-default.md), or our other presets, to find helpful presets
|
|
- Use presets by putting them in the `"extends"` array in your Renovate config file
|
|
- To manage the Renovate configuration for many repositories at once, create a global preset config file
|
|
- The order of presets matters: in a logical conflict, the last preset in the `"extends"` array "wins"
|