This feature is available exclusively as part of the Pro plan and is not
included in the Lite plan. Please refer to our pricing
page for more information about our plans
and features.
New to CodeRabbit reports? Start with the reports
overview to understand the basics before diving
into customization.
What you can customize
Content & data
Choose specific pull request information, comments, CI/CD status, and linked
issues to include in your reports.
Format & structure
Define report layout using markdown formatting, tables, bullet points, and
custom grouping patterns.
Filtering & sorting
Include or exclude PRs based on labels, status, team members, or custom
criteria you define.
Language support
Generate reports in multiple languages by specifying your preferred language
in the prompt.
Creating Custom Report Templatesโ
Basic Structureโ
A custom report template consists of instructions that tell CodeRabbit what information to include and how to present it. Hereโs a basic example:Example for different languagesโ
Japanese:Available Data Pointsโ
Your custom reports can access the following PR information that you can reference in your prompts:Pull Request Statusโ
Contained within the<pr_details>
tag.
-
Merged
: boolean (true/false) - Whether the PR has been merged -
Draft
: boolean (true/false) - Whether the PR is in draft state -
State
: string (โopenโ/โclosedโ) - Current state of the PR -
Mergeable
: boolean (true/false) - Whether the PR can be merged -
Is stale
: boolean - Whether PR has been inactive for over 168 hours -
PR Stage
: string - The current stage of open PRs in Open or Draft state, can be one of:- โNeeds Author Actionโ - PR requires author attention due to merge conflicts, draft status, or requested changes
- โWaiting for Author to Mergeโ - PR has approvals and is ready for author to merge
- โWaiting for Code Reviewsโ - PR is waiting for reviewers to approve
- undefined - PR is not in an open state (is merged or closed)
Basic Informationโ
Contained within the<pr_details>
tag.
Pull request number
: number - The PRโs identifierTitle
: string - PR titleURL
: string - Link to the PRAuthor name
: string - PR creatorโs usernameCreated at
: datetime - When the PR was createdLast activity
: datetime - Most recent activity timestampClosed at
: datetime (if applicable) - When the PR was closedSource branch
: string - Source branch nameTarget branch
: string - Target branch nameLabels
: array of strings - All labels applied to the PRReviewers
: array of strings - Assigned reviewersโ usernames
Summarized PR Detailsโ
-
<pr_description>
: string - Contains the body of your pull request (aka the PR description at the top of the PR page). -
<file_changes_summary>
: string - Contains a file by file summary of the changes made in the PR in markdown format. This summary is generated by CodeRabbit AI during the PR review process. This includes several sections for each file that was changed:filename
: string - The name of the file that was changed.AI-generated summary of changes
: markdown - An overall summary of the changes made in the file.Alterations to the declarations of exported or public entities
: markdown - A more specific breakdown of the changes made to the file such as exactly what was added, removed, or modified.
Commentsโ
-
<pr_comments>
: array of comment objects - Contains all the comments made on the PR. -
<comment>
: object - Each indidvidual comment is wrapped in this tag and is an object with the following properties:<comment_author_username>
: string - The username of the comment author.<comment_created_at>
: datetime - The date and time the comment was created.<comment_updated_at>
: datetime - The date and time the comment was last updated.<comment_body>
: markdown - The content of the comment.
CI/CD Check Statusโ
-
<pr_checks>
: array of check objects - Contains all CI/CD checks for the PR. GitHub Only. -
<pr_check>
: object - Each individual check is wrapped in this tag and is an object with the following properties:<pr_check_name>
: string - The name of the CI/CD check.<pr_check_status>
: string - The status of the check (e.g., โsuccessโ, โfailureโ, โin_progressโ, โcanceledโ).<pr_check_url>
: string - The URL to view the detailed results of the check.
Example prompt
Formatting options
CodeRabbit supports full markdown formatting in your custom reports:Text formatting
Bold, italic,
code
, and regular text with headers using #
, ##
,
###
.Lists & tables
Bullet points, numbered lists, and structured tables for organized data
presentation.
Links & blocks
Hyperlinks to PRs, code blocks for examples, and any other standard markdown
elements.
Headers and Titlesโ
The name you give to each report in the CodeRabbit menu will be used for the first line of any report or the subject for emails. For example if your report is namedExecutive Summary Template
then this string will appear on the subject of your emails and start of all message chains.
When using the Preview Report
button in the CodeRabbit menu, the subject will begin with Preview: <report name>
.
The reports will also have an overall title describing the report content such as Pull Request Summary Report (January 2025)
.
To change these details of this overall title you should include specific instructions in your custom prompt with examples such as:
Language Supportโ
You can generate reports in multiple languages by specifying the ISO language code in your template. For example:Advanced Featuresโ
Filteringโ
Include specific filtering instructions in your template:Custom Groupingโ
Organize information using custom grouping rules:Optional Data Sourcesโ
You can also include optional data sources in your custom reports. By default, CodeRabbit will not include the following data sources. In a custom report you will see the option to include these data sources by clicking theSelect Optional Data Sources
button. This adds special XML tags to your prompt that allow you to include this data in your report.
Bot Commentsโ
Bot comments are comments made by bots and Coderabbit AI on a PR. To enable bot comments you must include the tag<include_bot_comments>
in your prompt.
These are very similar in structure to regular user comments but with a few key differences:
-
<bot_comments>
: array of comment objects - Contains all the comments made on the PR. -
<bot_comment>
: object - Each individual comment is wrapped in this tag and is an object with the following properties:<bot_name>
: string - The username of the comment author.<bot_comment_created_at>
: datetime - The date and time the comment was created.<bot_comment_updated_at>
: datetime - The date and time the comment was last updated.<bot_comment_body>
: markdown - The content of the comment.
Issues and Ticketsโ
Issues and tickets brings in conversations, descriptions, and comments from Jira and Linear as part of your report if the ticket is linked in your PR description. To enable issues and tickets you must include the tag<include_issues_and_tickets>
in your prompt.
-
<issues_and_tickets>
: array of issue objects - Contains all the linked issues and tickets. -
<issue>
: object - Each individual issue is wrapped in this tag and is an object with the following properties:-
<issue_title>
: string - The title or thread ID of the issue. -
<issue_url>
: string - The URL to the issue. -
<issue_id>
: string - The unique identifier of the issue. -
<issue_author>
: string - The username of who created the issue. -
<issue_created_at>
: datetime - The date and time the issue was created. -
<issue_updated_at>
: datetime - The date and time the issue was last updated. -
<issue_body>
: markdown - The content/description of the issue. This contains the following sections:<issue_description>
: markdown - The description of the issue.<issue_comments>
: array of comment objects - Contains all the comments made on the issue.
-
Remove PRs without a โScore Card/Chartโ bot commentโ
This option gives you the ability to create a report limited only to pull requests containing a โScore Cardโ or โScore Chartโ bot comment from CodeRabbit or other bots. To enable issues and tickets you must include the tag<pr_score_card>
in your prompt.
IMPORTANT: This will automatically remove any pull requests from your reports if they do not contain a โScore Cardโ or โScore Chartโ bot comment. Using this option without setting up a flow to create these comments will result in No new pull request activity in the last XYZ hours
errors. Do not enable this option unless you have asked CodeRabbit to create a โScore Cardโ through a comment or implemented the โScore Chartโ bot comment flow below.
For example, you can ask CodeRabbit to check several conditions on a pull request and produce a โScore Chartโ:
Click to view example User Score Card/Chart Comment:
Click to view example User Score Card/Chart Comment:

Click to view resulting Score Card/Chart bot comment:
Click to view resulting Score Card/Chart bot comment:

Click to view example Report Prompt when using Score Card/Chart:
Click to view example Report Prompt when using Score Card/Chart:


- The reporting bot only has access to your comments and summary (like a project manager) if you want to make a report looking for these score card/chart comments make sure the reviewer does this ahead of time.
- Only include checks for very specific scenarios, such as a specific check failing or using tabs vs spaces.
- Do not use general rules without explaining specifically what they mean. If you add โInsure the pull request follows development best practicesโ you must define what โdevelopment best practicesโ actually mean or the AI will guess.
- Make one point for each specific check and make sure its a True/False condition.
- Instead of manually commenting on pull requests, you can use the GitHub Actions Bot to automatically comment on pull requests and trigger CodeRabbit score card/chart comments by including
@coderabbitai
in the comment.
Best practices
Be specific
Clearly define what should be included/excluded, use precise language to avoid ambiguity, and specify exact metrics you want to track.
Structure matters
Start with high-level summaries, use consistent grouping patterns, and include clear section breaks for better readability.
Keep it relevant
Focus on actionable information, avoid redundant data points, and consider your audienceโs specific needs and workflows.
Optimize readability
Use appropriate formatting, include visual breaks, and maintain consistent styling throughout your reports.
Use examples
Include โdo thisโ and โdonโt do thisโ examples, demonstrate proper formatting patterns, and show concrete use cases.
Maintain consistency
Use
<overall_instructions>
and <example>
tag blocks to ensure consistent formatting across teams and report types.Add Examples for Consistent Formattingโ
Try to use<overall_summary>
and <example>
tag blocks to keep consistency across reports: