> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fairfood.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Trace -Storytelling Interface

## Storytelling Interface

A view into the story behind your products.
<div class="flex flex-row gap-3 justify-start"><a class="px-[14px] py-2 flex flex-row gap-[10px] items-center border rounded-lg text-gray-600 dark:text-gray-400 hover:text-gray-700 dark:hover:text-gray-300 bg-white/50 border-gray-200 dark:border-gray-800 dark:bg-codeblock/50 hover:border-gray-400 hover:dark:border-gray-500" target="_blank" rel="noopener noreferrer" href="https://fairfood.atlassian.net/wiki/spaces/THD/overview"><svg class="h-3.5 w-3.5 hidden group-hover:block fill-gray-500 dark:fill-gray-400 group-hover:fill-gray-700 dark:group-hover:fill-gray-200" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><path d="M362.7 19.3L314.3 67.7 444.3 197.7l48.4-48.4c25-25 25-65.5 0-90.5L453.3 19.3c-25-25-65.5-25-90.5 0zm-71 71L58.6 323.5c-10.4 10.4-18 23.3-22.2 37.4L1 481.2C-1.5 489.7 .8 498.8 7 505s15.3 8.5 23.7 6.1l120.3-35.4c14.1-4.2 27-11.8 37.4-22.2L421.7 220.3 291.7 90.3z" /></svg><small class="text-sm leading-4">How does trace works</small></a></div>

### All about your chain

Trace will automatically generate the product story for you when you create transactions. You can share this story with the world via a QR code or link.  Furthermore, you can customise the interface to match your brand's look and feel. Let's take a closer look at the elements of the storytelling interface.

<img height="200" src="https://mintcdn.com/fairfood/80Y4DLisfHafVit3/images/ci.png?fit=max&auto=format&n=80Y4DLisfHafVit3&q=85&s=e7cc60f337a1cf3d34001a61af8cb870" data-path="images/ci.png" />

Cover Area

This is the main area where people land when they follow your Trace link or QR code. This is where the key takeaways are located (title), along with your brand logo, a hero image, claims, a call to action, a share button, and project info is displayed.

Activities and  Projects

Do you want to communicate more than just the product narrative? Perhaps, some initiatives you have undertaken with the farming community or a success story. These can be highlighted in the Projects section, with or without extra stats.

Product Journey

Trace will automatically generate and map out the journey of your product based on the location of your partners and the information they have provided. It provides a straightforward overview of the entire supply chain behind your product.

In addition to locations, Trace will also outline the stages of the product journey step by step. This feature enables you to provide a more in-depth description of your supply chain partners, including the events that took place at each stage, information about the product at that moment, as well as when and where they occurred.

Video

Do you wish to discuss more about the product or go beyond the product itself? You can always do so in the video section by adding your YouTube video (or another image).

### Customise to your aesthetics

Before developing a custom storytelling page, Fairfood's design team will work with you to incorporate your house-style colours into the page, and send you a few options to choose from.  Let's explore the details of each area and the customisation options.

Cover Area

<Steps>
  <Step title="Brand details">
    <img className="block dark:hidden" src="https://mintcdn.com/fairfood/mue2WthdgXa-O-CD/images/storytelling/brand-b-1.png?fit=max&auto=format&n=mue2WthdgXa-O-CD&q=85&s=d1f3472147d4fba53e1062b8dd4f764d" alt="connection" width="1504" height="850" data-path="images/storytelling/brand-b-1.png" />

    <img className="hidden dark:block" src="https://mintcdn.com/fairfood/mue2WthdgXa-O-CD/images/storytelling/brand-b.png?fit=max&auto=format&n=mue2WthdgXa-O-CD&q=85&s=3c5fd5703d18147926917c91d66fc8bb" alt="Hero Dark" width="1505" height="850" data-path="images/storytelling/brand-b.png" />

    Brand Details

    Brand details will appear in the top left corner of the interface. We can customise,
    Brand name: Maximum length 80 characters

    Brand Logo: Recommend a logo file size of 85x65px and in PNG format with transparent background.

    Brand URL: Users can be redirected to the company website when they click on the logo.
  </Step>

  <Step title="Banner Details">
    <img className="block dark:hidden" src="https://mintcdn.com/fairfood/mue2WthdgXa-O-CD/images/storytelling/banner.png?fit=max&auto=format&n=mue2WthdgXa-O-CD&q=85&s=9183337161f0496025431edf2d4b7491" alt="connection" width="1504" height="850" data-path="images/storytelling/banner.png" />

    <img className="hidden dark:block" src="https://mintcdn.com/fairfood/mue2WthdgXa-O-CD/images/storytelling/banner-b.png?fit=max&auto=format&n=mue2WthdgXa-O-CD&q=85&s=ea257b1e22c7e1a2208407597e48edef" alt="Hero Dark" width="1505" height="850" data-path="images/storytelling/banner-b.png" />

    We can change the following details,
    Page Title: Recommend 1 sentence, 30-60 charactersAction Button Text: Less than 20 characters.

    Banner logo mode: You can use the banner logo in full-width image  mode or half-width image mode. Action button URL: You can specify the action button URL also you can choose not to show the action buttonBanner Images:

    Full banner image: PNG or JPG with 1350x950px resolution

    Half banner image: PNG or JPG with 640x950px resolutionMobile banner Image: PNG or JPG with 640x950px resolution
  </Step>

  <Step title="Activities and  Projects">
    <img className="block dark:hidden" src="https://mintcdn.com/fairfood/mue2WthdgXa-O-CD/images/storytelling/project.png?fit=max&auto=format&n=mue2WthdgXa-O-CD&q=85&s=cf9976997effe712155c8b1f87c920a3" alt="connection" width="1504" height="850" data-path="images/storytelling/project.png" />

    <img className="hidden dark:block" src="https://mintcdn.com/fairfood/mue2WthdgXa-O-CD/images/storytelling/project-b.png?fit=max&auto=format&n=mue2WthdgXa-O-CD&q=85&s=4db65c3ccf58cabdeb83babee14b1e2f" alt="Hero Dark" width="1505" height="850" data-path="images/storytelling/project-b.png" />

    We can change the following details,
    Project title: Maximum 75 characters.Project description: Maximum 400 characters.Project stats: You can suggest 3-4 important numbers regarding the project or you can choose not to specify any.The stats should have a name that is less than 25 characters.

    Stats should have value (whole number) with or without a unit.
  </Step>
</Steps>

Product Story

<Steps>
  <Step title="Map">
    <img className="block dark:hidden" src="https://mintcdn.com/fairfood/mue2WthdgXa-O-CD/images/storytelling/map.png?fit=max&auto=format&n=mue2WthdgXa-O-CD&q=85&s=facca842918c522d726f9cf17e31c193" alt="connection" width="1504" height="850" data-path="images/storytelling/map.png" />

    <img className="hidden dark:block" src="https://mintcdn.com/fairfood/mue2WthdgXa-O-CD/images/storytelling/map-b.png?fit=max&auto=format&n=mue2WthdgXa-O-CD&q=85&s=a808c3c928df9cd1bd7b643fd3e603c1" alt="Hero Dark" width="1505" height="850" data-path="images/storytelling/map-b.png" />

    Brand Details

    Map is automatically generated by the system based on the location of your supply chain actors and transactions. You can use your brand colours there.
  </Step>

  <Step title="Product stages">
    <img className="block dark:hidden" src="https://mintcdn.com/fairfood/mue2WthdgXa-O-CD/images/storytelling/chain.png?fit=max&auto=format&n=mue2WthdgXa-O-CD&q=85&s=93e726d09d78880343471f522f53f73e" alt="connection" width="1504" height="850" data-path="images/storytelling/chain.png" />

    <img className="hidden dark:block" src="https://mintcdn.com/fairfood/mue2WthdgXa-O-CD/images/storytelling/chain-b.png?fit=max&auto=format&n=mue2WthdgXa-O-CD&q=85&s=6104692e23163c4e3335fbbb9c95bbd3" alt="Hero Dark" width="1505" height="850" data-path="images/storytelling/chain-b.png" />

    Product stages are also generated by the system based on the role of the actors in your chain. You can also customise the stage names, colours, and icons.
  </Step>

  <Step title="Supply chain actors and products">
    <img className="block dark:hidden" src="https://mintcdn.com/fairfood/mue2WthdgXa-O-CD/images/storytelling/product.png?fit=max&auto=format&n=mue2WthdgXa-O-CD&q=85&s=76c3e7c1fd2c0cbdbc28d82647622346" alt="connection" width="1504" height="850" data-path="images/storytelling/product.png" />

    <img className="hidden dark:block" src="https://mintcdn.com/fairfood/mue2WthdgXa-O-CD/images/storytelling/product-b.png?fit=max&auto=format&n=mue2WthdgXa-O-CD&q=85&s=932ca4ee15ae26fc9b7fa32b03ab8469" alt="Hero Dark" width="1505" height="850" data-path="images/storytelling/product-b.png" />

    You can locate the entities involved in the supply chain by clicking on each stage. For each entity, you will be able to view the products and transactions associated with them, along with their respective descriptions.
    The following details are customisable in this section,
    Actor Images: PNG or JPG file with a size of 160x160px is recommended.Actor description: Maximum 250 characters.

    Product Image: PNG or JPG file with a size of 160x160px is recommended.Product description: Maximum 200 characters.
  </Step>
</Steps>

Video & Social Media

<Steps>
  <Step title="Video">
    <img className="block dark:hidden" src="https://mintcdn.com/fairfood/mue2WthdgXa-O-CD/images/storytelling/vdeo.png?fit=max&auto=format&n=mue2WthdgXa-O-CD&q=85&s=8db4d2389ae2d1c9cb73a8c96902083e" alt="connection" width="1504" height="850" data-path="images/storytelling/vdeo.png" />

    <img className="hidden dark:block" src="https://mintcdn.com/fairfood/mue2WthdgXa-O-CD/images/storytelling/vdeo-b.png?fit=max&auto=format&n=mue2WthdgXa-O-CD&q=85&s=85af614afd27b1d8c1167dc97da43343" alt="Hero Dark" width="1505" height="850" data-path="images/storytelling/vdeo-b.png" />

    You can choose to display any youtube video in this section. You can also mention a short description and title for the video.
    Video title: Maximum 60 charactersVideo description: Maximum 200 characters
  </Step>

  <Step title="Social media">
    <img className="block dark:hidden" src="https://mintcdn.com/fairfood/mue2WthdgXa-O-CD/images/storytelling/socialmedia.png?fit=max&auto=format&n=mue2WthdgXa-O-CD&q=85&s=a1687377022ca1e5c24483196381cb8f" alt="connection" width="1504" height="850" data-path="images/storytelling/socialmedia.png" />

    <img className="hidden dark:block" src="https://mintcdn.com/fairfood/mue2WthdgXa-O-CD/images/storytelling/socialmedia-b.png?fit=max&auto=format&n=mue2WthdgXa-O-CD&q=85&s=400814780364e339a99299cc78b5f05b" alt="Hero Dark" width="1505" height="850" data-path="images/storytelling/socialmedia-b.png" />

    Your customers have the ability to share your story on social media or locate you within the social media realm. You have the option to determine what the default message they share will be.
    You can customise the following information in this section,
    Social media links: Your Facebook, LinkedIn, Twitter and Instagram links.Share message: Default share message when someone wants to share your story.You can also decide to show or hide the social media components
  </Step>
</Steps>

### Customisation At a Glance

You can find the summary of items you can customise in the interface below.
