Add support for Trac ticket cross-reference

Notice: This plugin is unmaintained and available for adoption.


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.


2 / 2


1 / 1


Download the zipped source from here.

The plugin is also available on PyPI.


You can check out TracTicketReferencePlugin from here using Subversion, or browse the source with Trac.


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

18618 by jun66j5 on 2024-01-22 13:17:44
TracTicketReferencePlugin: fix missing import for reduce (refs #14274)
18617 by jun66j5 on 2024-01-20 03:22:45
TracTicketReferencePlugin: modify Python in the classifiers with 2.7 and 3, and enable [bdist_wheel] universal option (refs #14274)
18616 by jun66j5 on 2024-01-20 03:18:44
TracTicketReferencePlugin: make compatible with Trac 1.6 (closes #14274)


Author: t2y
Maintainer: none (needsadoption)

Last modified 3 years ago Last modified on Dec 21, 2020, 5:43:02 PM

Attachments (4)

Download all attachments as: .zip