> ## 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.

# Order - Documents

> Manage files and documents attached to an order

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="Orders > [Order] > Documents">
  <img src="https://mintcdn.com/twicecommerce/JxIwwhJBSe50yPLx/images/order-attachments-tab.webp?fit=max&auto=format&n=JxIwwhJBSe50yPLx&q=85&s=2a47b80a99076a7b0f1137c6e9690091" alt="Order attachments tab showing uploaded files" width="1920" height="1080" data-path="images/order-attachments-tab.webp" />
</Frame>

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

<Card title="Open in TWICE Admin" icon="external-link" href="https://admin.twicecommerce.com/orders" horizontal>
  orders/\[order-id]/attachments
</Card>

## Primary Purpose

The Documents tab allows you to upload and manage files related to the order such as contracts, photos, or supporting documentation.

<AccordionGroup>
  <Accordion title="Upload Documents">
    Attach contracts, rental agreements, damage reports, or any relevant documentation to the order.
  </Accordion>

  <Accordion title="Add Photos">
    Upload photos of items before pickup, condition documentation, or proof of delivery.
  </Accordion>

  <Accordion title="Organize Files">
    Categorize attachments by type and add descriptions for easy retrieval.
  </Accordion>

  <Accordion title="Rename Files">
    Rename any uploaded file from the row actions menu. The file's storage location stays the same — only the display name changes.
  </Accordion>

  <Accordion title="Share with Customers">
    Optionally make specific attachments available to customers through their order portal.
  </Accordion>
</AccordionGroup>

## Related Concepts

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

<AccordionGroup>
  <Accordion title="Document Types">
    Different attachment types serve different purposes: contracts for legal records, photos for condition tracking, receipts for accounting.
  </Accordion>

  <Accordion title="Audit Trail">
    Documents become part of the order's permanent record for dispute resolution and compliance.
  </Accordion>
</AccordionGroup>

## Visibility and Permissions

Access to this view is controlled by your <Tooltip tip={userRoleDefinition}>user role</Tooltip>.

<Tabs>
  <Tab title="Visibility" icon="eye">
    | Feature          | Admin | Manager | Member |
    | ---------------- | ----- | ------- | ------ |
    | View Documents   | ✓     | ✓       | ✓      |
    | Upload Files     | ✓     | ✓       | ✗      |
    | Rename Files     | ✓     | ✓       | ✗      |
    | Delete Documents | ✓     | ✗       | ✗      |
  </Tab>

  <Tab title="Permissions" icon="key">
    | Resource         | Admin  | Manager | Member |
    | ---------------- | ------ | ------- | ------ |
    | File Management  | Manage | Edit    | View   |
    | Upload Documents | Manage | Edit    | View   |
    | Customer Sharing | Manage | Edit    | View   |
  </Tab>
</Tabs>
