> For the complete documentation index, see [llms.txt](https://docs.tracr.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tracr.com/tracr-user-guide/whats-new.md).

# Whats New?

Here's what's new in Tracr.

### Editing Assets <a href="#fancy-colours-extended-to-gia-list" id="fancy-colours-extended-to-gia-list"></a>

Users now have much more control over which are assets are displayed in the galleries associated with an individual diamond. You can add and remove images to the rough and split galleries of polished diamonds, and you can have multiple images of the same type.

See the [full documentation](/tracr-user-guide/12.-editing-assets.md).

### Fancy Colours extended to GIA list (1.35) <a href="#fancy-colours-extended-to-gia-list" id="fancy-colours-extended-to-gia-list"></a>

We initially launched with a subset of fancy colours in 1.33. We have extended that list to support the full GIA coloured diamonds list.

| GIA Fancy Colour | Tracr FancyColour enum value |
| ---------------- | ---------------------------- |
| Blue-Gray        | B\_GY                        |
| Blue-Green       | B\_G                         |
| Brown-Orange     | BN\_O                        |
| Brown-Pink       | BN\_P                        |
| Brown-Purple     | BN\_PL                       |
| Brown-Red        | BN\_R                        |
| Brown-Yellow     | BN\_Y                        |
| Gray-Blue        | GY\_B                        |
| Gray-Green       | GY\_G                        |
| Gray-Purple      | GY\_PL                       |
| Gray-Violet      | GY\_V                        |
| Green-Blue       | G\_B                         |
| Green-Gray       | G\_GY                        |
| Green-Yellow     | G\_Y                         |
| Orange-Brown     | O\_BN                        |
| Orange-Yellow    | O\_Y                         |
| Pink-Brown       | P\_BN                        |
| Pink-Purple      | P\_PL                        |
| Purple-Red       | PL\_R                        |
| Purple-Brown     | PL\_BN                       |
| Purple-Gray      | PL\_GY                       |
| Purple-Pink      | PL\_P                        |
| Red-Brown        | R\_BN                        |
| Red-Purple       | R\_PL                        |
| Violet-Gray      | V\_GY                        |
| Yellow-Brown     | Y\_BN                        |
| Yellow-Gray      | Y\_GY                        |
| Yellow-Green     | Y\_G                         |
| Yellow-Orange    | Y\_O                         |

### Shipments Improvements (1.34.0)

We've made some improvements to the Shipments interfaces, both inbound and outbound.

On the inbound shipments you can now select multiple rough shipments and accept any that are awaiting acceptance in bulk. This process uses the same slide out drawer control used in other places such as transfer, share and unlock.

We've also begun to split the shipments into multiple views to separate the active shipments and the archived shipments. Over time we will continue to separate out the views and make further improvements to the shipments flows.

### Locked Diamond Page  (1.34.0)

We have made an update to the Tracr platform designed to improve the user journey for all diamonds that are registered as polished on Tracr but currently in a "locked" state.

Previously, searching for a locked diamond resulted in a "not found" page. We are replacing this with a new, informative landing page. Users will now be greeted by a page that clearly explains the diamond’s locked status and showcases the value of Tracr’s provenance and verification capabilities.

Find out more [here](#locked-diamond-page).&#x20;

### Fancy Colours  (1.33.0)

We have made an update to the Tracr platform to improve the way users upload fancy coloured diamonds and how they show up in the platform and search interfaces.

### Lab Eligibile (1.32.0)

We have made an update to the platform to help users work out if their diamonds are eligible for grading through a 3rd party grading lab. If the diamond is not eligible, the user will be informed with a reason, and a recommended action.&#x20;

This information will also be available to the 3rd party labs so both parties have the information required to move a diamond through the grading process.

### Update box/shipment information (1.28.0)

You can now edit the details of the container (box, shipment) that a rough diamond is registered against in Tracr.

If you accidentally register a diamond against the incorrect box or shipment, you can now correct this without having to contact support. These values can be edited using the Tracr API.

If you change the box or shipment details then Tracr will automatically invalidate any Rough Check matches against the updated diamond and will perform a new match using the updated details.

***

### Transfer from Inventory (1.27.0)

The Transfer from Inventory feature provides a fast and structured way to move diamonds from your available inventory to recipients. This process eliminates the need for manual CSV exports and imports by allowing you to handle transfers directly within the platform.

More details [here](/tracr-help-pages/shipments/shipments-outbound-transfer-from-inventory.md)

### Lab Eligibility (1.27.0)

Tracr has been working on integrations with trusted grading labs which will allow you to submit a diamond to a grading lab with a Tracr ID to link your grading report to the Tracr digital record.

> There is also the option with some labs (GIA, IoD) to add your Tracr provenance to the grading report. This requires a diamond to be unlocked.

A diamond needs to have a few requirements met to be eligible for grading through one of our integrations. These include: being a polished diamond and having a supported scan report that Tracr can process.

We have extended the Portal and Tracr API to provide you with the LAB ELIGIBLE status and the breakdown of the eligibility requirements.

***

### Changes to provenance information display (1.26.0)

Tracr remains dedicated to driving industry success and transparency across the diamond supply chain. To support the continued growth of our platform and secure its long-term business viability, we have introduced an important update to how provenance information is managed.

Provenance information is not available until the diamond is polished and unlocked.

### Update Participant ID / ERP ID / Stock ID

For any Tracr diamond, you can now update the Participant ID by changing the Stock ID value in your Sarine software and that update will flow through to the diamond record in Tracr.

It’s also possible to update the Participant ID against a diamond in Tracr using the API. Documentation for that is [here](https://docs.tracr.com/docs/tracr-api/202db28925f02-update-rough-diamond)

***

## Inventory

#### Rough and Split Diamonds

For rough and split diamonds, your diamond will have one of two new values for **Provenance**: single provenance or mixed provenance.

<figure><img src="https://174689295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fdxsd3IyWOYfN3nRPyMfr%2Fuploads%2FUAqukcIjgxPaCrVyYruI%2F11564f17-5a90-4e64-9927-a8902773b053.png?alt=media&amp;token=3e548dbe-545f-4eab-a5b8-390d4e9b8198" alt=""><figcaption><p>New values for Provenance</p></figcaption></figure>

#### Polished Diamonds

For polished diamonds, you will need to unlock a diamond to see the provenance information.

If your diamond is locked, your diamond will have one of two new values for **Provenance**: single provenance or mixed provenance.

If your diamond is unlocked, your diamond will have a mixed provenance or the country of origin.

> Note: **DTC** is an example of a mixed provenance, and will be available on unlock.

<figure><img src="https://174689295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fdxsd3IyWOYfN3nRPyMfr%2Fuploads%2FpxZi1xzHw3vqmeHcQGDM%2F21d5a3c6-6053-45f0-bdac-106ffd987530.png?alt=media&amp;token=97e7070b-a5ba-42b1-9e1c-0edf7c4feaa1" alt=""><figcaption><p>Example of polished inventory with differing provenance information</p></figcaption></figure>

### Participant Search and Share

#### Rough and Split Diamonds

For rough and split diamonds, your diamond will have one of two new values for **Provenance**: single provenance or mixed provenance.

<figure><img src="https://174689295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fdxsd3IyWOYfN3nRPyMfr%2Fuploads%2FQ5hGrLWSLZFT0y9cdghr%2F6f7b6b9f-afbd-482f-99fe-92d8c4f172e8.png?alt=media&amp;token=b0f840b7-b318-40f7-9d20-d4e6a71dd3e1" alt=""><figcaption><p>Example of a rough diamond with single provenance.</p></figcaption></figure>

#### Polished Diamonds

If your diamond is locked, it will **not** be available in Participant Search and Share.

If your diamond is unlocked, your diamond will have a mixed provenance or the country of origin.

<figure><img src="https://174689295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fdxsd3IyWOYfN3nRPyMfr%2Fuploads%2FqRPCX8dJMDXfrWnHeygG%2F80b32d2f-4366-4655-a5bb-c5c831e304e5.png?alt=media&amp;token=9c38931f-4a07-40bd-9d81-5dbbbc4f83d2" alt=""><figcaption><p>Example of a polished, unlocked diamond witgh a single provenance: Botswana.</p></figcaption></figure>

### Tracr API and Tracr Search API

Where provenance is returned in the Tracr API and Tracr Search API, the following changes will come into effect.

#### Mixed Provenance

{% tabs %}
{% tab title="New - Rough, Split & Polished Locked" %}

```json
{
  ...
  "provenance": 
  {
    "is_country_code_available": false,
    "is_locked": true,
    "provenance_name": "",
    "provenance_type": "Entity"
  }
}
```

{% endtab %}

{% tab title="New - Polished Unlocked" %}

```json
{
  ...
  "provenance": 
  {
    "is_country_code_available": false,
    "is_locked": false,
    "provenance_name": "DTC",
    "provenance_type": "Entity"
  }
}
```

{% endtab %}

{% tab title="Previous" %}

```json
{
  ...
  "provenance": 
  {
    "is_country_code_available": false,
    "is_locked": false,
    "provenance_name": "DTC",
    "provenance_type": "Entity"
  }
}
```

{% endtab %}
{% endtabs %}

#### Single Provenance

{% tabs %}
{% tab title="New - Rough, Split & Polished Locked" %}

```json
{
  ...
  "provenance": 
  {
    "is_country_code_available": true,
    "is_locked": true,
    "provenance_name": "",
    "provenance_type": "Country"
  }
}
```

{% endtab %}

{% tab title="New - Polished Unlocked" %}

```json
{
  ...
  "provenance": 
  {
    "is_country_code_available": true,
    "country_code": "BW",
    "is_locked": false,
    "provenance_name": "BW",
    "provenance_type": "Country"
  }
}
```

{% endtab %}

{% tab title="Previous" %}

```json
{
  ...
  "provenance": 
  {
    "is_country_code_available": true,
    "country_code": "BW",
    "is_locked": false,
    "provenance_name": "BW",
    "provenance_type": "Country"
  }
}
```

{% endtab %}
{% endtabs %}

***

## Table Improvements (version 1.24.0)

Tracr has improved our interface to enable better user experience. The first step is the inventory table.

There is an updated look and feel, as well as improvements including:

* Ability to copy fields
* Reordering columns
* Pagination
* Improved column resizing

***

## Search by Report/Inscription Number (version 1.24.0)

This version of Tracr introduces the ability to search using grading report numbers and inscription numbers across the Tracr Inventory, Participant Search, and Diamond Experience.

***

## Archive and unarchive diamonds in your inventory (version 1.23.0)

This version of Tracr introduces the ability to separate your inventory into **Active** and **Archived** sections.

<figure><img src="https://174689295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fdxsd3IyWOYfN3nRPyMfr%2Fuploads%2FfuTUHHkm6DDG03nAvGct%2F79c139a9-4e26-4644-9688-8ec1f24a114c.png?alt=media&amp;token=5663183a-5bfb-4f58-ae9d-fb354771a2c8" alt=""><figcaption><p>Active and Archived sections.</p></figcaption></figure>

If you sell a diamond or remove it from the Tracr process, you can archive the diamond so that it is no longer appears in your **Active** inventory but instead appears in your **Archived** inventory. If you later withdraw a diamond for sale, or the buyer of the diamond becomes a Tracr participant and you want to transfer the digital asset to them, you can unarchive the diamond so that it moves back to your **Active** inventory.

On the **Archived** tab you can only view or unarchive a diamond. You cannot edit, share, or unlock an archived diamond.

<figure><img src="https://174689295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fdxsd3IyWOYfN3nRPyMfr%2Fuploads%2Fysxnlrlkgf3IZhZss3BQ%2F8c73af1d-f925-4ce9-83e3-c49bc4c6f551.png?alt=media&amp;token=7684af65-d709-4133-8bf4-5fdb3a26230b" alt=""><figcaption><p>View or unarchive an archived diamond</p></figcaption></figure>

***

## Transferring status (version 1.23.0)

This version of Tracr introduces a new status, **Transferring**, to help users know which diamonds are available to archive. Diamonds in an active Transfer have the status **Transferring**.

> Note: **Transferring** status can be displayed for rough, split and polished diamonds.

***

## Shipments outbound and inbound (version 1.15.0)

This version of Tracr introduces a change to the transfer process. A non-De Beers producer can now register rough diamonds on the Tracr platform. Once registered, the producer can create a shipment of rough diamonds and send that shipment to a manufacturer using the shipment outbound workflow. Accepting the inbound shipment allows the manufacturer to load diamonds using the Integration Tool against that shipment up to the bounds of the shipment (count, total carats, carat range).

***

## Rough Check (version 1.14.0)

This version of Tracr includes the addition of Rough Check in the Portal. Rough Check is a check against a rough diamond uploaded by the producer and the rough diamond a manufacturer uploads.

This check is performed using Diamond ID, a core service in the Tracr platform ecosystem primarily tasked with validating, verifying, and identifying diamonds.

You will be able to see a Rough Check against your diamond in your Rough Inventory and on the Diamond Details page.

<figure><img src="https://174689295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fdxsd3IyWOYfN3nRPyMfr%2Fuploads%2FdizfkkOXnjjx0inu547p%2F987ab672-2ab5-48a9-90b2-19796cdac9a4.png?alt=media&amp;token=d89f1b58-5bb6-45df-9be1-dda24b9b1bd0" alt=""><figcaption><p>Rough Check in the Rough Inventory.</p></figcaption></figure>

## Changes to transfer in (version 1.13.0)

In this version of Tracr, the 'transfer in' workflow has been simplified and inscription numbers no longer need to be provided when accepting transfers of polished diamonds.

In the following image, the recipient has accepted five diamonds, rejected three diamonds, the sender has cancelled one diamond, and one diamond is available for transfer. The **Accept** and **Reject** buttons allow this diamond to be accepted (without the need to upload a CSV file containing Tracr IDs and inscription numbers) or rejected.

<figure><img src="https://174689295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fdxsd3IyWOYfN3nRPyMfr%2Fuploads%2F3OzKxnAiOg7tsaFRKHmy%2Ff968c5c6-7ed9-42d5-b3d1-03686ef7d19d.png?alt=media&amp;token=96335ff1-4575-43a9-9fa6-b1c7111f483a" alt=""><figcaption><p>Accepting ownership of diamonds.</p></figcaption></figure>

***

## Diamond unlocking (version 1.10.0)

From 1st January 2024, all new polished diamonds added to Tracr will be automatically locked.

To share or transfer a locked diamond, the owner must first unlock the diamond. Participants can unlock one or more locked diamonds from their inventory or from the Diamond Details page.

{% hint style="warning" %}
To make sure that stones that are unlocked are accessible for future use, you will not be able to delete an unlocked stone. Please make sure you are happy with the stone you are unlocking and that it has all the necessary assets.
{% endhint %}

The following video shows you how to unlock a diamond from your inventory.

{% embed url="<https://vimeo.com/894062765/314cd85a3f>" %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.tracr.com/tracr-user-guide/whats-new.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
