> For the complete documentation index, see [llms.txt](https://developer.harness.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.harness.io/resilience-testing/chaos-engineering/faults/custom-faults/custom-fault-templates.md).

# Custom Fault Templates

Learn how to create custom chaos faults using pre-configured templates for faster development

This approach provides pre-configured templates that you can customize for your specific needs, enabling faster development and ensuring best practices.

## Overview <a href="#overview" id="overview"></a>

Custom fault templates offer a streamlined way to create chaos faults by starting with proven patterns and configurations. Templates include industry-standard settings, safety measures, and common parameters that can be customized for your specific use case.

## When to Use <a href="#when-to-use" id="when-to-use"></a>

Choose this approach when:

* Your use case aligns with common fault patterns
* You want to quickly prototype and iterate on fault designs
* You prefer guided configuration over building from scratch
* You want to ensure best practices are followed
* You need to rapidly deploy multiple similar faults

## Creating a Custom Fault Template <a href="#creating-a-custom-fault-template" id="creating-a-custom-fault-template"></a>

1. Navigate to **Project Settings** for your project and open your existing **Chaos Hub** or create a new one.

   ![Project Settings](https://2284173296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlSkpbpeYJ3rfGUkIrcyQ%2Fuploads%2Fgit-blob-2c2e1fdb9febaa3aec19636a6d5bf397a8b1c54a%2Fnew-fault-template.png?alt=media)
2. Click **New Fault Template**, and add the basic details likes **Name**, **Description**, **Tags**, and **Category**. Then click **Configure Details**.

   ![New Fault](https://2284173296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlSkpbpeYJ3rfGUkIrcyQ%2Fuploads%2Fgit-blob-e985d98a3f638f06b9a1dd7a13442362b181e177%2Fbasic-properties.png?alt=media)
3. Configure the execution properties and parameters for your custom fault, then click **Create Fault Template**.

   ![New Fault](https://2284173296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlSkpbpeYJ3rfGUkIrcyQ%2Fuploads%2Fgit-blob-3247147b6bd947d678250a98d6362a974eecf32d%2Fadvance-properties.png?alt=media)
4. Now, go back to **Project Settings** for your project and open **Chaos Faults**.
5. Click **Custom Faults** on the top-right, then click the dropdown arrow next to **New Fault** and select **Start with a template**.

   ![New Fault](https://2284173296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlSkpbpeYJ3rfGUkIrcyQ%2Fuploads%2Fgit-blob-60507f2e9fefe0ec711fcfe1d8c535b2a793e973%2Fstart-with-a-template.png?alt=media)
6. Select the custom fault template you created, you will find that in your project's **Chaos Hub**.

   ![New Fault](https://2284173296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlSkpbpeYJ3rfGUkIrcyQ%2Fuploads%2Fgit-blob-198e653bc86d0bfb1156e6e2031191fd771c5d32%2Ffind-template.png?alt=media)
7. Select your fault template and click **Create as Local Copy**.

   ![New Fault](https://2284173296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlSkpbpeYJ3rfGUkIrcyQ%2Fuploads%2Fgit-blob-642a249508c849039a74f3015311cd450de3e452%2Fselect-your-template.png?alt=media)
8. Configure the basic details for your fault. The fault properties will be automatically populated from the template. Review and modify as needed, then click **Create Fault**.

   ![New Fault](https://2284173296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlSkpbpeYJ3rfGUkIrcyQ%2Fuploads%2Fgit-blob-3efe60a3a4bc2e56d0d6f17f571908a99b44227a%2Fadvance-details.png?alt=media)
9. That's it! Add your custom fault to experiments as you would with any other fault.

## Next Steps <a href="#next-steps" id="next-steps"></a>

* [Create and run chaos experiments](/resilience-testing/chaos-engineering/new-to-chaos-engineering/quickstart.md)
* [Learn about chaos experiment best practices](/resilience-testing/chaos-engineering/chaos-experiments/index.md)

{% @harness-feedback/feedback %}