Add support for Trac ticket cross-reference


This plugin adds "Relationships" fields to each ticket, enabling you to express cross-references between tickets. This plugin requires Trac 0.12 or higher. Also tested on Trac 1.0.

Key features:

  • Provide simple cross-reference as Trac custom field, called ticketref.
  • Create new ticket with related ticket's field value.
  • Picking up the referred ticket in comment.

New Ticket with Relationships:

New Ticket with Relationships

Query Result with Relationships:

Query Result with Relationships

Pick up "ref* #id" in comment as cross-reference:

Picking up the referred ticket in comment

Clicking "Relationships" label displays the id with summary:

Relationships field with verbose information

This plugin was inspired by MasterTicketsPlugin.

Bugs/Feature Requests

Existing bugs and feature requests for TracTicketReferencePlugin are here.

If you have any issues, create a new ticket.


Download the archived source from here.


You can clone TracTicketReferencePlugin from here using Mercurial, or browse the source.


General instructions on installing Trac plugins can be found on the TracPlugins page.


To enable and configure the plugin, add the following to your trac.ini file:

ticketref.* = enabled

ticketref = textarea
ticketref.label = Relationships
ticketref.cols = 68
ticketref.rows = 1

If you want to show more small field, change as follows:

ticketref = text
ticketref.label = Relationships

Since 0.4.0, configure reference keywords for CommitTicketUpdater to get ticket reference like this. Note both close and refs keywords are used:

commit_ticket_update_commands.close = fix fixed fixes
commit_ticket_update_commands.refs = ref refs refer

i18n/l10n Support

This plugin is able to localize field label or message. You can translate into your language using "ticketref/locale/messages.pot".

And then, I'm willing to merge your contribution into the distribution. So, let me know if you localized "ticketref/locale/messages.pot".

See also Localization (L10N) of Trac.

Recent Changes



Author: t2y
Maintainer: Tetsuya Morimoto

Last modified 2 years ago Last modified on Apr 16, 2018, 6:31:11 PM

Attachments (4)

Download all attachments as: .zip