--- title: "Create a Tracker" slug: "create-a-tracker" tags: ["Tracker Creation", "Templates"] updated: 2026-04-23T12:56:06Z published: 2026-04-23T12:56:06Z canonical: "help.tuleap.com/create-a-tracker" --- > ## Documentation Index > Fetch the complete documentation index at: https://help.tuleap.com/llms.txt > Use this file to discover all available pages before exploring further. # Create a Tracker This article will walk you through the creation of a new Tracker step by step. --- ## Activate the Tracker service To be able to use trackers in your project, you must first check that the service is activated. Go to the project admin area, in the "Services" tab, select the "Trackers" service and activate it. Check out our article [Introduction to Tuleap Services](/docs/en/introduction-to-tuleap-services#activate-a-service-in-tuleap) for a detailed demo of how to activate a service in a Tuleap project. All the trackers of the project will be accessible by selecting the "Trackers" service in the services menu. All that's left to do is select the tracker you want to use. ## Create a Tracker > [!WARNING] > Warning > > You must be a project administrator to create a new tracker To create a new Tracker, simply click on ![Button to add a new tracker for monitoring purposes on the interface.](https://cdn.document360.io/79854fff-060e-43bf-bca3-f7bb88550673/Images/Documentation/Capture d’écran 2025-12-08 à 12.33.28.png?sv=2026-02-06&spr=https&st=2026-11-22T20%3A10%3A08Z&se=2026-11-22T21%3A10%3A08Z&sr=b&sp=r&sig=Io3lCA%2BNUzc4XWNL0x24kvDbpKbamQYXTDTWSET%2BgKU%3D) Two steps are then necessary: - **Choose a model** - **Name your tracker.** When creating a tracker, you have the option to select a template from the templates stored in the platform or the trackers created in the other projects you administer. There are 3 types: - The **templates defined by your company** in the "Custom templates" section ![Select a tracker template from available options in the Enalean platform.](https://cdn.document360.io/79854fff-060e-43bf-bca3-f7bb88550673/Images/Documentation/Capture d’écran 2026-01-10 à 19.58.50.png?sv=2026-02-06&spr=https&st=2026-11-22T20%3A10%3A08Z&se=2026-11-22T21%3A10%3A08Z&sr=b&sp=r&sig=I6h%2BDD4aOuZWXz65UMmH5%2BNSCjKna748xX3iokKj%2Bgk%3D) - The **default templates** provided by the Tuleap editor ![Overview of Tuleap templates for managing activities and bugs effectively.](https://cdn.document360.io/79854fff-060e-43bf-bca3-f7bb88550673/Images/Documentation/Capture d’écran 2026-01-20 à 12.03.21.png?sv=2026-02-06&spr=https&st=2026-11-22T20%3A10%3A08Z&se=2026-11-22T21%3A10%3A08Z&sr=b&sp=r&sig=JlMclsd01Ns3n74aQy9GVRRG6%2BN2Oo8%2FWCPeKAN2cL8%3D) - Templates for **advanced users** ![Options for creating a new tracker from various sources in a user interface.](https://cdn.document360.io/79854fff-060e-43bf-bca3-f7bb88550673/Images/Documentation/Capture d’écran 2026-01-10 à 19.59.06.png?sv=2026-02-06&spr=https&st=2026-11-22T20%3A10%3A08Z&se=2026-11-22T21%3A10%3A08Z&sr=b&sp=r&sig=OdzA5pzLXuQ%2BoVj7f6pfa5Uiq2Q1hkXIItRJccZloHw%3D) In this part, you can choose to use: - A tracker of an existing project of which you are the administrator. **This means that you can reuse a tracker that you have already set up for another project.** > [!WARNING] > Warning! > > This copies only the configuration, not the artifacts. - **An empty tracker:** allows you to create a tracker from scratch. You will have to select the different types of fields you want to use as well as the semantics and permissions you want to apply to the tracker. - **An XML file:** if you have the structure of an XML tracker, from another project or platform, you can import it. For more information, see the article on [import-export in XML](/docs/en/tracker-import-export#structure-import-export). - **The "From Jira" option** : allows you to import your existing tickets from a Jira server to your newly created Tracker on Tuleap To finalize the creation of a tracker you must fill in: - **Name:** will be displayed in Tuleap - **Color:** you can choose the color that will be used in the different parts of Tuleap - **Description** (optional): allows you to define the usefulness of the tracker, its role and the information that will be stored on it. - **Short name** (predefined): it references the elements inside the tracker. If the short name already exists, Tuleap will automatically offer you to change it. ![Creating a new tracker with fields for name, shortname, and description.](https://cdn.document360.io/79854fff-060e-43bf-bca3-f7bb88550673/Images/Documentation/Capture d’écran 2026-01-10 à 20.00.43.png?sv=2026-02-06&spr=https&st=2026-11-22T20%3A10%3A08Z&se=2026-11-22T21%3A10%3A08Z&sr=b&sp=r&sig=X4kGy7fUtHYPgKVcGF1y3F2MJ0y73ZjM%2BB49wtfsZFM%3D) Once the Tracker is created, you will be automatically redirected to the main page of the new Tracker. ![Congratulations message indicating successful creation of the Anomalies tracker in Tuleap.](https://cdn.document360.io/79854fff-060e-43bf-bca3-f7bb88550673/Images/Documentation/Capture d’écran 2026-01-10 à 20.02.00.png?sv=2026-02-06&spr=https&st=2026-11-22T20%3A10%3A08Z&se=2026-11-22T21%3A10%3A08Z&sr=b&sp=r&sig=U3g6UEuCFIsIqSMEuHXV2hb7Vd78Z8axqHUvUJoI4VI%3D) A Tracker is a tool for tracking a type of information that allows you to create, manage and track a set of artifacts that share the same nature. The unitary element that makes up an artifact, the numbers and the configuration of the fields is done in the description of the tracker