A Strong Performer in The Forrester Wave™: Digital Experience Platforms, Q4 2025
CS-log-dark.svg

Workflow Board App Installation Guide

The Workflow Board is a Full Page Location app, which displays the workflow stages and tasks in a Kanban format. You can view the list of workflows along with the workflow stages and workflow tasks for content types within your Contentstack environment. You can drag and drop the tasks from one workflow stage to another and update the required details. Also, the app enables you to search for workflows and entries in the Workflow Board app. You can apply various filters to sort the workflow task cards.

Contentstack Marketplace lets you integrate the Workflow Board app directly into your headless CMS. You can easily use this app to view the workflows of your stack. It displays all the workflow stages and tasks on the Workflow Board app in a Kanban view.

Prerequisites

Let's follow this step-by-step guide to install and configure the Workflow Board app within your stack.

Steps for Execution

  1. Install and Configure the Workflow Board app in Contentstack Marketplace
  2. Use Workflow Board within your Stack

  1. Install and Configure the Workflow Board app in Contentstack Marketplace

    Follow the steps to install the application in Contentstack.

    1. Log in to your Contentstack account.
    2. Navigate to the “App Switcher” icon in the top-right corner and click Marketplace.

       

      Click to enlarge

    3. Click Apps from the left panel.
    4. Within the Marketplace, you can see all the available apps. Hover over the Workflow Board app and click Install App.

       

      Click to enlarge

    5. In the popup window, select the stack where you want to install the Workflow Board app and click the Install button.
      Click to enlarge

    6. On the UI Locations tab, you can see the predefined app locations. You can use the toggle button corresponding to each UI location to enable or disable it based on your requirements. 
      Click to enlarge

    7. NoteNo additional configuration is required to use the Workflow Board app.

  2. Use Workflow Board within your Stack

    To use the Workflow Board application in your stack, follow the steps given below:

    1. Log in to your Contentstack account.
    2. In the left-hand side primary navigation, click Settings of your stack, navigate to Workflows, and then click + New Workflow to create a new workflow.
      Click to enlarge
    3. Enter the Workflow Name and Description, select the Scope, add the Workflow Stages and Workflow Superuser(s), Enable the workflow, and click the Save button.
      Click to enlarge

      This creates your new workflow.
      Click to enlarge

      NoteYou can also set the Publish Rules for the workflow stages.

    4. Now, click Entries in the left navigation panel, open the entry that belongs to the content type added to the workflow, and then click the Workflow Details icon in the right navigation panel of your entry.
      Click to enlarge
    5. Set the workflow stage of an entry and assign the workflow task to the user or role, add comments, and then click Save.
      Click to enlarge

      You can track the workflow tasks assigned by clicking Tasks in the left-hand side primary navigation panel.
      Click to enlarge

      Additional ResourceFor more information about Workflows, Workflow Stages, Workflow Tasks, and Publish Rules, please refer to the Set up Workflows and Publish Rules documentation.

    Workflow Board App

    1. Now, go to the stack dashboard. In the left-hand side primary navigation, you will find the Workflow Board app icon (as shown below).
      Click to enlarge

      NoteWorkflow Board is a Full Page Location app. For more information, refer to the Full Page Location documentation.

    2. Click the app icon to view the Workflow Board app within your CMS.
      Click to enlarge
    3. You first need to authorize the app by providing access to your stack. Click the Authorize button to start using the app.
      Click to enlarge

    4. In the popup window, click the Authorize button again to authenticate the Workflow Board app.
      Click to enlarge

      The Workflow Board app will show a list of all workflows in the left panel and all the workflow stages and tasks (entries) on the right side of the board.
      Click to enlarge

      NoteThe first created workflow is visible on top of the list. By default, the Workflow Board app displays the workflow stages and entries for the first created workflow.

      TipIf Workflows are already created and not visible on screen, please contact the Super Admin to remove the Workflow Old API plan from your organization.

    5. Click the Edit Workflow icon to edit the workflow in the Contentstack Workflow editor.
      Click to enlarge

      Also, you can search for any workflow using the search bar.
      Click to enlarge
    6. Click the Collapse icon to hide the list of workflows.
      Click to enlarge

    7. Click the Expand icon to show the list of workflows if the sidebar is collapsed.
      Click to enlarge

      NoteBy default, the sidebar for the list of workflows is always visible.

    8. To view the workflow stages and tasks (entries), click the workflow name in the left panel of the Workflow Board app.
      Click to enlarge

      NoteOn page reload or page navigation, the app shows the workflow where it was before refreshing the landing page.

    9. Workflow Stages

      10. The Workflow Board app displays the workflow stages and the total number of entries that belong to the stage on the top of the board. You can scroll right to view all the workflow stages.
    10. Click to enlarge

    11. Workflow Tasks

      12. The Workflow task (or entry) preview card shows all the associated details. You can view the Entry title, Content type name, Release name (if any), Locale, and the number of assignees. You can use the vertical scroll bar to see all the workflow tasks.
    12. Click to enlarge

      13. If a task is not assigned to any user or role, the card shows the Unassigned state.
    13. Click to enlarge

      14. If a task is assigned to a user, the card shows the total number of assignees in the User(s) category. Hover over the User(s) category to view all the assigned users' names.
    14. Click to enlarge

      15. If a task is assigned to a role, the card shows the total number of roles assigned to the entry in the Role(s) category. Hover over the Role(s) category to view all the permitted roles.
    15. Click to enlarge
    16. Drag and drop a workflow task card to move it from one workflow stage to another.
      Click to enlarge

      When you drop a task in another stage, a popup appears to update the status of the workflow task. Set the required details, and click the Update button.
      Click to enlarge

      The task, now, is visible in another stage.
      Click to enlarge

      NoteIf the workflow task is restricted from any workflow stage, you can see a message when you drag the card to that stage.

    17. Workflow Board Filters

    18. The Workflow Board app lets you apply filters based on the entries.

      • Search an Entry: You can search an entry by typing the entry title in the search bar.
        Click to enlarge

        Also, you can view the total number of entries in a workflow on the Workflow Board app. Click the Reload icon to update the number if any entry is added or deleted.
        Click to enlarge
      • Content Type Filter: You can view the workflow tasks (entries) based on the selected Content Type(s). By default, the All Content Types option is selected.
        Click to enlarge
      • Sort By Filter: You can shuffle and sort the tasks (entries) according to the available sorting options.
        Click to enlarge

        By default, the Modified At: Newest option is selected. It enables you to view the entries arranged in their recently modified order.
        Click to enlarge

        Select the Title (ASC) option from the Sort By dropdown to view the entries arranged in the ascending alphabetical order of the entry titles.
        Click to enlarge

        Select the Title (DESC) option from the Sort By dropdown to view the entries arranged in descending alphabetical order of the entry titles.
        Click to enlarge

        Select the Modified At: Oldest option from the Sort By dropdown to view the entries arranged in the order as per the oldest modified entry.
        Click to enlarge

        Select the Created At: Newest option from the Sort By dropdown to view the entries arranged in their recently created order.
        Click to enlarge

        Select the Created At: Oldest option from the Sort By dropdown to view the entries arranged in the order as per the oldest created entry.
        Click to enlarge

      • View Type Filter: You can preview the workflow task cards in a Comfortable or Compact view.
        Click to enlarge

        By default, the Comfortable option is selected.
        Click to enlarge

        Select the Compact option from the View Type dropdown to view the workflow task cards in compact view.
        Click to enlarge