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

# Stock Item - Events

> View the complete history and lifecycle events of a stock item over time

export const viewAccessDefinition = "Read-only access without ability to make changes.";

export const editAccessDefinition = "Update and read data, but cannot create or delete.";

export const manageAccessDefinition = "Create, update, read, and delete data.";

export const permissionsDefinition = "The actions you are authorized to perform.";

export const visibilityDefinition = "Which features, sections, or data tables are visible to you.";

export const userRoleDefinition = "What a user can see and do. Each user has one built-in system role — Owner, Admin, Manager, or Member — and can also be assigned any number of custom roles you create with specific permissions. Effective access is the combination of all their roles.";

<Frame caption="Inventory > Stock Items > [Item] > Events">
  <img src="https://mintcdn.com/twicecommerce/lZhc_tO8u1u_bL0Q/images/stock-item-events-tab.webp?fit=max&auto=format&n=lZhc_tO8u1u_bL0Q&q=85&s=1ae48153d760c337f141a2214978a78d" alt="Stock item events showing chronological history of orders, reservations, and notes" width="1920" height="1080" data-path="images/stock-item-events-tab.webp" />
</Frame>

<Info>
  This view can look different dependent on your user role. <br />See [Visibility & Permissions](#visibility-and-permissions) for details.
</Info>

<Info>
  **New to Stock Items?** Understand how Stock Items differ from SKUs in our [Stock Item vs SKU](/docs/inventory/stock-item-vs-sku) guide.
</Info>

## Primary Purpose

The Events tab provides a chronological view of all <Tooltip tip="Orders, Reservations, or Notes" href="/docs/concepts/inventory/events" cta="Learn more">events</Tooltip> in a stock item's lifecycle, from creation to current status.

<AccordionGroup>
  <Accordion title="Filter by Event Type">
    Review specific events by filtering for Orders, Reservations, or Notes to focus on customer bookings, internal reservations, or documentation entries.
  </Accordion>

  <Accordion title="Search by Event Name">
    Quickly find events by searching for specific names, descriptions, or comments associated with each activity.
  </Accordion>

  <Accordion title="Review by Date Range">
    Focus on specific time periods by filtering events within custom date ranges to analyze seasonal patterns or specific timeframes.
  </Accordion>
</AccordionGroup>

## Related Concepts

Here are a few key concepts of TWICE Commerce that relate to Events.

<AccordionGroup>
  <Accordion title="Temporal Data">
    Events use <Tooltip tip="Time-based data that shows how item status changes over time">temporal tracking</Tooltip> to provide historical context for all item activities.
  </Accordion>

  <Accordion title="Event Types">
    Different <Tooltip tip="Orders (customer-facing), Reservations (internal), and Notes (documentation)" href="/docs/concepts/inventory/events" cta="Learn more">event types</Tooltip> are displayed: Orders block availability and are managed under 'Orders', Reservations block availability and are managed in the Events tab, and Notes don't block availability and are managed in the Events tab.
  </Accordion>

  <Accordion title="Utilization Analysis">
    Event data feeds into <Tooltip tip="Reports showing how often and how long items are in use" href="/docs/reports" cta="Learn more">utilization reports</Tooltip> for business intelligence.
  </Accordion>
</AccordionGroup>

## Visibility and Permissions

Access to this view is controlled by your <Tooltip tip={userRoleDefinition}>user role</Tooltip>. Your user role determines both
<Tooltip tip={visibilityDefinition}>visibility</Tooltip> and
<Tooltip tip={permissionsDefinition}>permissions</Tooltip> for
<Tooltip tip={manageAccessDefinition}>manage</Tooltip>,
<Tooltip tip={editAccessDefinition}>edit</Tooltip>, and
<Tooltip tip={viewAccessDefinition}>view</Tooltip> access levels.

<Tabs>
  <Tab title="Visibility" icon="eye">
    | Feature           | Admin | Manager | Member |
    | ----------------- | ----- | ------- | ------ |
    | View Events       | ✓     | ✓       | ✓      |
    | Order History     | ✓     | ✓       | ✓      |
    | Financial Events  | ✓     | ✓       | ✗      |
    | Export Event Data | ✓     | ✓       | ✗      |
  </Tab>

  <Tab title="Permissions" icon="key">
    | Resource          | Admin  | Manager | Member |
    | ----------------- | ------ | ------- | ------ |
    | View All Events   | Manage | Manage  | View   |
    | Add Manual Events | Manage | Edit    | View   |
    | Export Data       | Manage | Edit    | View   |
  </Tab>
</Tabs>

## Related Guides

<CardGroup cols={2}>
  <Card title="Stock Item Events Concept" icon="book" href="/docs/concepts/inventory/events">
    Learn about event types, attachments, and lifecycle
  </Card>
</CardGroup>