You can import code reviews from a Gerrit instance using the gerrit service name.

Example Service

Here’s an example of a gerrit project:

service = gerrit
gerrit.base_uri =
gerrit.username = your_username
gerrit.password = your_http_digest_password
service = "gerrit"
base_uri = ""
username = "your_username"
password = "your_http_digest_password"

The above example is the minimum required to import issues from Gerrit.

Note that the password is typically not your normal login password. Go to the “HTTP Password” section in your account settings to generate/retrieve this password.

You can also pass an optional ssl_ca_path option which will use an alternative certificate authority to verify the connection.

You can also feel free to use any of the configuration options described in Common Service Configuration Options.

Specify the Query to Use for Gathering Patchsets

By default, the Gerrit plugin will query patchsets based on this simple API query:


You may override this query string through your bugwarriorrc file.

For example:

gerrit.query = is:open+((reviewer:self+-owner:self+-is:ignored)+OR+assignee:self)
query = "is:open+((reviewer:self+-owner:self+-is:ignored)+OR+assignee:self)"

Provided UDA Fields

Field Name




Gerrit Branch

Text (string)


Gerrit Change ID

Number (numeric)


Gerrit Summary

Text (string)


Gerrit Topic

Text (string)


Gerrit URL

Text (string)

The Gerrit service provides a limited set of UDAs. If you have need for some other values not present here, please file a request (there’s lots of metadata in there that we could expose).