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

# How to Display a Trello Board on Digital Signage Using Pickcel?

This guide shows you how to display a **Trello board** on your digital signage screens using Pickcel, which is excellent for visualizing workflows, tracking task progress, and managing team projects in a shared space.

## Prerequisites

Before you begin, make sure you have:

* An Atlassian account with access to the target Trello board
* Email and password login available for that account
* 2-Factor Authentication (2FA) enabled on the account, with the 2FA secret key available
* The full Trello board URL you plan to display

<Info>
  See our guide: [How to Set Up 2FA and Get a Secret Key](/apps/dashboard-apps/2fa-setup)
</Info>

<Warning>
  This integration requires a direct Atlassian account login with an email and password. Federated login methods, such as signing in with a Google, Microsoft, or Apple account, are not compatible with this setup. Please ensure you use an account with basic authentication credentials.
</Warning>

<Tip>
  **Best Practice:** For enhanced security and easier management, create a dedicated service account in Atlassian with read-only permissions for the Trello board you want to display. Use this account's credentials for Pickcel.
</Tip>

***

## Step-by-Step Configuration

<Steps>
  <Step title="Create the Dashboard App in Pickcel">
    Log in to the Pickcel Console and navigate to **Apps**. Search for the **Dashboard** app and click on it. Then, click **Create App**.

    <Frame>
      <img src="https://cdn.pickcel.com/images/support/apps/Dashboard_Apps/trello/trello_01.bUW2N-ZbZuOI.png" alt="Search for the Dashboard app and click Create App" />
    </Frame>

    * Give a name to the app instance based on the board you are configuring (e.g., "Project Phoenix Trello Board").
    * Select **Trello** from the dropdown menu. The configuration fields will open on the right.

    <Frame>
      <img src="https://cdn.pickcel.com/images/support/apps/Dashboard_Apps/trello/trello_02.4BnOPzSw3KRk.png" alt="Select Trello from the dropdown menu" />
    </Frame>
  </Step>

  <Step title="Fill in the Fields for Trello Dashboard Configuration">
    This section requires precise information to generate a correct and secure Auth Token.

    * **Atlassian Login URL**: Log out of Trello. Go to the Trello login page. Copy the **entire URL** from your browser's address bar and paste it here.

    <Frame>
      <img src="https://cdn.pickcel.com/images/support/apps/Dashboard_Apps/trello/trello_03.xKzn62VEhsv6.png" alt="Copy the Atlassian login URL from the address bar" />
    </Frame>

    <Frame>
      <img src="https://cdn.pickcel.com/images/support/apps/Dashboard_Apps/trello/trello_04.B_06EMO_edhv.png" alt="Paste the Atlassian login URL into the configuration field" />
    </Frame>

    * **Atlassian Email ID**: Enter the email address for your Atlassian Account.
    * **Atlassian Password**: Enter the password for that account.
    * **Auth Secret Key**: Paste the 2FA Secret Key you saved when setting up 2FA for the Atlassian account.
    * **Trello Board URL**: Log back into Trello and navigate to the exact board you want to display. Copy the **entire URL** from the address bar and paste it here.

    <Frame>
      <img src="https://cdn.pickcel.com/images/support/apps/Dashboard_Apps/trello/trello_05.RM8BzGON5L_t.png" alt="Copy the Trello board URL from the address bar" />
    </Frame>

    <Frame>
      <img src="https://cdn.pickcel.com/images/support/apps/Dashboard_Apps/trello/trello_06.5axPVY13_Xtj.png" alt="Paste the Trello board URL into the configuration field" />
    </Frame>

    Click **Generate Auth Token**. The token will be generated and automatically pasted into the **Auth Token** field on the left.

    <Frame>
      <img src="https://cdn.pickcel.com/images/support/apps/Dashboard_Apps/trello/trello_07.555Pc21SSjd_.png" alt="Generate Auth Token and view it in the Auth Token field" />
    </Frame>

    ### Enter Screen Selection Code (Optional)

    To display only specific lists on your board, use the Pickcel Dashboard Screen Mapper Extension. Select the area, and the generated code will be copied to your clipboard. Paste this code into the **Screen Selection Code** field.

    <Info>
      Check this guide for more info: [How to Use the Dashboard Screen Mapper Chrome Extension?](/apps/dashboard-apps/screen-mapper)
    </Info>
  </Step>

  <Step title="Set Refresh Interval and Session Expiry">
    * **Refresh Interval**: This setting defines how often the board screenshot is updated. An interval of **15 minutes** is a good starting point for most Trello boards.
    * **Session Expiry**: This forces a fresh login to prevent session timeouts. A value of **5-8 hours** is recommended.

    <Frame>
      <img src="https://cdn.pickcel.com/images/support/apps/Dashboard_Apps/trello/trello_08.mZnn4XezMdV8.png" alt="Set the refresh interval and session expiry" />
    </Frame>
  </Step>

  <Step title="Enable Scroll Option for the Board (Optional)">
    * **Enable Auto Scroll**: Set a scroll duration in seconds. For example, at 20 seconds, the entire board scrolls from top to bottom over 20 seconds.
    * **Enable Auto Scroll Height**: Set a scroll height in pixels. The screen scrolls down by the defined pixel height.

    <Frame>
      <img src="https://cdn.pickcel.com/images/support/apps/Dashboard_Apps/trello/trello_09.Q3BCuKf6MfMv.png" alt="Enable auto scroll options for the board" />
    </Frame>
  </Step>

  <Step title="Create and Publish">
    Once the configuration is complete, click **Create App**. The app instance will be available in the **Media** section.

    <Frame>
      <img src="https://cdn.pickcel.com/images/support/apps/Dashboard_Apps/trello/trello_10.5-AqMY-qumlV.png" alt="Click Create App to create the app instance" />
    </Frame>

    To preview, go to **Media**, find your app instance by name, and click its thumbnail. If you are happy with the result, assign it to your screens.

    <Frame>
      <img src="https://cdn.pickcel.com/images/support/apps/Dashboard_Apps/trello/trello_11.m9tETHwrm3Jk.png" alt="Find the app instance in the Media section and preview it" />
    </Frame>

    <Frame caption="Preview of the Trello Board">
      <img src="https://cdn.pickcel.com/images/support/apps/Dashboard_Apps/trello/trello_12.IUpKQeFXsnkc.png" alt="Trello board preview on Pickcel" />
    </Frame>

    <Warning>
      If the password or any other credentials are incorrect, the process will stall on the login screen, displaying the login screen instead of the board.
    </Warning>
  </Step>
</Steps>

***

## What's Next?

<Note>
  Your Trello Dashboard App is now ready. For further reading:

  * To create a multi-zone layout: Learn about [Compositions](/compositions/compositions)
  * To send it to your screens: Learn how to [Publish or Schedule Content](/schedule-and-publish/publish-overview)
</Note>