# Display customer sessions

> Customer sessions contain customer activity within a given Application. For example, a customer session can represent a shopping cart or a completed order for a given customer.

> For the complete documentation index, see [llms.txt](https://docs.talon.one/llms.txt).

:::tip Suggested reading

- [Events](/docs/dev/concepts/entities/events.md)
- [Customer sessions](/docs/dev/concepts/entities/customer-sessions.md)

:::

The state of a session can be one of the following:

- **Open**: The session can be modified as many times as needed, depending on your
  business needs. For example, the session remains open while the customer is adding new
  items to the cart.
- **Closed**: The session cannot be modified anymore, unless it is [reopened](/integration-api#tag/Customer-sessions/operation/reopenCustomerSession).
  If the customer has completed the payment step of the order workflow, for example,
  the session is closed.
- **Cancelled**: The session had an issue or the **closed** or **partially returned** states
  are not valid anymore. For example, the session is cancelled if the customer requested
  a full refund or the payment failed at checkout.
- **Partially returned**: The **closed** state is not valid anymore but the session is not
  **cancelled**. This occurs, for example, if the customer requested a refund for some of
  the items they purchased in the same session.

Each action of the customer in the session is represented by an event.
Every session contains at least one event.

## List customer sessions

To list the customer sessions within an Application:

1. Open the Application of your choice.
1. On the left-side menu, click <Sessions className="icon"/> **Sessions**.

The following information is displayed for the sessions. You can
also filter the list by [session state](docs/dev/concepts/entities/customer-sessions.md#customer-session-states)
or creation date.

{

    
      
        Column
        Description
      
    
    
      
          Session integration ID
          Identifier of the customer session. It can be used for integration purposes. It is unique for each Application.
      
      
          Customer integration ID
          
            Identifier of the customer profile. It can be used for integration purposes. It is the same across all Applications.
          
      
      
          Store integration ID
          Identifier of the store passed in the customer session. It can be used for integration purposes. It is unique for each store.
      
      
          State
          
            Indicates whether the session is open, closed, partially returned, or cancelled.
            <Admonition type="tip">
              Learn more about customer sessions in the Developer docs.
            </Admonition>
          
      
      
          Returned items
          Number of returned items.
      
      
          Items in session
          Number of items currently in the customer session.
      
      
          Coupon
          Any coupons redeemed by the customer in the session.
      
      
          Referral code
          Any referral codes used by the customer in the session.
      
      
          Created
          Date and time when the session was created in the time zone of the Application.
      
      
          Return items
          Allows you to return one or more cart items purchased by the customer in the session.
      
    

}

### Search customer sessions

You can filter searches for a session in your Application by the following:

- Session integration ID
- Customer integration ID
- Coupon code
- Store integration ID
- Referral code

To search for a session, enter a full or partial ID or code in the search field.
The search is not case-sensitive.

Any exact or partial matches for the session are displayed in a list.

:::note
To search for partial matches, enter at least three characters in the search field.
:::

## Customer session overview

Click a **Session integration ID** to access all the information for the corresponding customer session.

The session page displays the following information:

- **Session status:** Current state of the session.
- **Session integration ID:** Integration ID of the customer session.
- **Customer integration ID:** Integration ID of the customer. You can access the [customer profile](/docs/product/applications/display-customer-profiles.md)
  by clicking the ID.
- **Store integration ID:** Integration ID of the [store](/docs/dev/concepts/entities/stores.md)
  passed in the session.
- **Created:** Date and time when the session was created.
- **Last activity:** Date and time when the session was last updated.
- **Total discounts:** Total discounted amount for the session.
- **Net total:** Revenue produced by the customer in the session after deducting all
  discounts.
- **Session total:** Total value of cart items and additional costs in the session,
  before discounts are applied.
- Tabs with additional information related to the customer session:
  - [Events](#display-session-events)
  - [Attributes](#display-session-attributes)
  - [Cart items](#display-cart-items)
  - [Summary](#display-a-summary-of-the-session-activity)

### Display session events

Click the **Events** tab to list the
[events](/docs/product/applications/display-events.md) and [triggered
effects](/docs/dev/integration-api/api-effects) of the selected session:

| Column  | Description                                                                                                                                          |
| ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| Time    | Date and time when the event happened.                                                                                                               |
| Event   | The [event type](/docs/dev/concepts/entities/events.md#event-categories-and-types).                                                                       |
| Effects | Number of [effects](/docs/product/rules/effects/available-effects.md) triggered for the event. Click the link to display the details of each effect. |

:::tip
To export all the events for the session as a CSV file, to the right of the search bar, click <Export className="icon"/> **Export**.
:::

### Display session attributes

Click the **Attributes** tab to list
[any customer session attributes](/docs/product/account/dev-tools/manage-attributes.md)
set in the Application.

For example, attributes may refer to the shipping city, the operating system of the
customer's device, or the payment method.

:::note
The tab is available only if you set customer session attributes for the Application.
:::

### Display cart items

Click the **Cart items** tab to list all the cart items that were added to the selected session:

| Column   | Description                                            |
| -------- | ------------------------------------------------------ |
| SKU      | Unique stock keeping unit identifier of the cart item. |
| Price    | Cost of the cart item.                                 |
| Quantity | Number of cart item units added to the session.        |

You can expand each cart item to view more details, such as built-in and custom attributes.

:::note
The tab is available only if there are any events involving cart items in the session.
:::

### Display a summary of the session activity<ClosedBetaBadge/>

Click the <AiSuggest className="icon"/> **Summary** tab to get an AI-generated summary of
the session activity.

## Return individual cart items

You can manually return one or more cart items from a [closed or partially returned session](/docs/dev/concepts/entities/customer-sessions.md#customer-session-states).

This is useful, for example, to allow your [customer support agents](/docs/product/account/account-settings/manage-roles.md)
to return specific items when a customer requests a refund for part of their
purchase.

:::important
If you return one or more cart items using this feature, the session state changes to *partially
returned* if the original state was *closed*.

Updating the session state can cause rollback effects to undo potential previous effects
triggered when you closed or opened the session. Learn more in our [Developer docs](/docs/dev/tutorials/partially-return-a-session.md).
:::

To return individual cart items:

1. On the <Sessions className="icon"/> **Sessions** page, to the right of the session that
   contains the items to be returned, click <ReturnItems className="icon"/>.

   :::note
   In the **Returned quantity** column, you can see how many units have already been
   returned for each item.
   :::

1. In the pop-up that appears, select the items you want to return.
1. (Optional) Use the **Quantity** dropdown to select the number of units you want to
   return for each item.
1. Click **Return Selected Items**.

The number of returned items automatically appears in [the **Returned items** column of the session](#list-customer-sessions)
and it is subtracted from the **Items in session** column.

## Export customer sessions

Export your customer sessions as a CSV file to import this data in other tools, for example,
in any BI tool to run reports.

To export customer sessions:

1. On the leftmost menu, click <Apps className="icon" /> **Apps**.
1. Select the Application from which you want to export the sessions and click <Campaign className="icon" /> **Campaigns**.
1. In the top-right corner, click **Manage Campaign Data** > <Export className="icon" /> **Export Customer Sessions**.
1. Set your desired time frame:
   - In the **Date Range** tab, set your desired dates.
   - In the **After Recent Export** tab, select any previous customer session export
     from the **Created after** drop-down menu.
1. In **Customer session state**, select the state of your choice.
1. In **Date format**, select the date format of your choice.

   :::note
In the exported file, all timestamp values follow `UTC+00:00`.
:::

1. Click **Export Data**.

## Related pages

- [Display customer profiles](/docs/product/applications/display-customer-profiles.md)
- [Display events](/docs/product/applications/display-events.md)
- [Display stores](/docs/product/applications/display-stores.md)
- [Manage attributes](/docs/product/account/dev-tools/manage-attributes.md)
- [Return individual items](/docs/dev/tutorials/partially-return-a-session.md)
- [Export triggered effects](/docs/product/rules/effects/export-triggered-effects.md)