From e39234865413649f80f49570159ae018cca98f0f Mon Sep 17 00:00:00 2001
From: Oliver <oliver.henry.walters@gmail.com>
Date: Fri, 22 May 2026 00:17:11 +1000
Subject: [PATCH 01/10] [UI] Calendar tooltips (#11980)

* Allow tooltips for calendar entries

* Render tooltip for purchase order calendar

* Calendar tooltip renderers

* Add tooltip for build calendar

* Add key to filter list

* Display responsible owner
---
 .../src/components/calendar/Calendar.tsx      | 48 ++++++++++++++-
 .../src/components/calendar/OrderCalendar.tsx |  6 +-
 .../calendar/OrderCalendarToolTip.tsx         | 61 +++++++++++++++++++
 .../src/components/render/Company.tsx         |  8 +--
 src/frontend/src/pages/build/BuildIndex.tsx   | 15 ++++-
 .../src/pages/purchasing/PurchasingIndex.tsx  | 15 ++++-
 src/frontend/src/pages/sales/SalesIndex.tsx   | 26 +++++++-
 .../src/tables/InvenTreeTableHeader.tsx       |  1 +
 8 files changed, 166 insertions(+), 14 deletions(-)
 create mode 100644 src/frontend/src/components/calendar/OrderCalendarToolTip.tsx

diff --git a/src/frontend/src/components/calendar/Calendar.tsx b/src/frontend/src/components/calendar/Calendar.tsx
index 8b80347fce..dcddcdcfd1 100644
--- a/src/frontend/src/components/calendar/Calendar.tsx
+++ b/src/frontend/src/components/calendar/Calendar.tsx
@@ -1,4 +1,8 @@
-import type { CalendarOptions, DatesSetArg } from '@fullcalendar/core';
+import type {
+  CalendarOptions,
+  DatesSetArg,
+  EventContentArg
+} from '@fullcalendar/core';
 import allLocales from '@fullcalendar/core/locales-all';
 import dayGridPlugin from '@fullcalendar/daygrid';
 import interactionPlugin from '@fullcalendar/interaction';
@@ -15,6 +19,7 @@ import {
   Box,
   Button,
   Group,
+  HoverCard,
   Indicator,
   LoadingOverlay,
   Popover,
@@ -29,7 +34,13 @@ import {
   IconDownload,
   IconFilter
 } from '@tabler/icons-react';
-import { useCallback, useEffect, useMemo, useState } from 'react';
+import {
+  type ReactNode,
+  useCallback,
+  useEffect,
+  useMemo,
+  useState
+} from 'react';
 import { useShallow } from 'zustand/react/shallow';
 import {
   defaultLocale,
@@ -44,6 +55,7 @@ export interface InvenTreeCalendarProps extends CalendarOptions {
   enableDownload?: boolean;
   enableFilters?: boolean;
   enableSearch?: boolean;
+  eventTooltipContent?: (event: EventContentArg) => ReactNode;
   filters?: TableFilter[];
   isLoading?: boolean;
   state: CalendarState;
@@ -53,6 +65,7 @@ export default function Calendar({
   enableDownload,
   enableFilters = false,
   enableSearch,
+  eventTooltipContent,
   isLoading,
   filters,
   state,
@@ -112,6 +125,36 @@ export default function Calendar({
     [calendarProps.datesSet, state.ref, state.setMonthName]
   );
 
+  const wrappedEventContent = useCallback(
+    (arg: EventContentArg) => {
+      const inner =
+        typeof calendarProps.eventContent === 'function'
+          ? calendarProps.eventContent(arg, null)
+          : (calendarProps.eventContent ?? null);
+
+      if (!eventTooltipContent) return inner;
+
+      const tooltip = eventTooltipContent(arg);
+
+      if (!tooltip) return inner;
+
+      return (
+        <HoverCard
+          openDelay={300}
+          closeDelay={100}
+          shadow='md'
+          position='top-start'
+        >
+          <HoverCard.Target>
+            <div style={{ width: '100%', overflow: 'hidden' }}>{inner}</div>
+          </HoverCard.Target>
+          <HoverCard.Dropdown>{tooltip}</HoverCard.Dropdown>
+        </HoverCard>
+      );
+    },
+    [calendarProps.eventContent, eventTooltipContent]
+  );
+
   return (
     <>
       {state.exportModal.modal}
@@ -217,6 +260,7 @@ export default function Calendar({
             footerToolbar={false}
             {...calendarProps}
             datesSet={datesSet}
+            eventContent={wrappedEventContent}
           />
         </Box>
       </Stack>
diff --git a/src/frontend/src/components/calendar/OrderCalendar.tsx b/src/frontend/src/components/calendar/OrderCalendar.tsx
index 9c3523653e..95fd76abe3 100644
--- a/src/frontend/src/components/calendar/OrderCalendar.tsx
+++ b/src/frontend/src/components/calendar/OrderCalendar.tsx
@@ -46,12 +46,14 @@ export default function OrderCalendar({
   model,
   role,
   params,
-  filters
+  filters,
+  tooltip
 }: {
   model: ModelType;
   role: UserRoles;
   params: Record<string, any>;
   filters?: TableFilter[];
+  tooltip?: (event: EventContentArg) => React.ReactNode;
 }) {
   const navigate = useNavigate();
   const user = useUserState();
@@ -106,6 +108,7 @@ export default function OrderCalendar({
         const end: string = order.target_date || start;
 
         return {
+          order: order,
           id: order.pk,
           title: order.reference,
           description: order.description,
@@ -209,6 +212,7 @@ export default function OrderCalendar({
       state={calendarState}
       filters={calendarFilters}
       editable={true}
+      eventTooltipContent={tooltip}
       eventContent={renderOrder}
       eventClick={onClickOrder}
       eventChange={onEditOrder}
diff --git a/src/frontend/src/components/calendar/OrderCalendarToolTip.tsx b/src/frontend/src/components/calendar/OrderCalendarToolTip.tsx
new file mode 100644
index 0000000000..dba5259358
--- /dev/null
+++ b/src/frontend/src/components/calendar/OrderCalendarToolTip.tsx
@@ -0,0 +1,61 @@
+import type { EventContentArg } from '@fullcalendar/core';
+import type { ModelType } from '@lib/enums/ModelType';
+import { resolveItem } from '@lib/functions/Conversion';
+import { t } from '@lingui/core/macro';
+import { Badge, Divider, Group, Stack, Text } from '@mantine/core';
+import { formatDate } from '../../defaults/formatters';
+import { RenderInstance } from '../render/Instance';
+import { RenderOwner } from '../render/User';
+
+export default function OrderCalendarToolTip({
+  event,
+  instanceLookup,
+  modelType
+}: {
+  event: EventContentArg;
+  instanceLookup: string;
+  modelType: ModelType;
+}) {
+  // Extract the order instance from the event
+  const order = event?.event?._def?.extendedProps?.order;
+
+  const instance = resolveItem(order, instanceLookup);
+
+  if (!order) return null;
+
+  return (
+    <Stack gap='xs'>
+      <RenderInstance model={modelType} instance={instance} />
+      <Divider />
+      <Group gap='xs'>
+        <Text size='sm' fw='bold'>
+          {order.reference}
+        </Text>
+        <Text size='xs'>{order.description || order.title}</Text>
+      </Group>
+      {order.start_date && (
+        <Group gap='xs'>
+          <Text size='sm' fw='bold'>{t`Start Date`}</Text>
+          <Text size='xs'>{formatDate(order.start_date)}</Text>
+        </Group>
+      )}
+      {order.target_date && (
+        <Group gap='xs'>
+          <Text size='sm' fw='bold'>{t`Target Date`}</Text>
+          <Text size='xs'>{formatDate(order.target_date)}</Text>
+          {order.overdue && (
+            <Badge size='sm' color='red'>
+              {t`Overdue`}
+            </Badge>
+          )}
+        </Group>
+      )}
+      {order.responsible && (
+        <Group gap='xs'>
+          <Text size='sm' fw='bold'>{t`Responsible`}</Text>
+          <RenderOwner instance={order.responsible_detail} />
+        </Group>
+      )}
+    </Stack>
+  );
+}
diff --git a/src/frontend/src/components/render/Company.tsx b/src/frontend/src/components/render/Company.tsx
index e8050d5f12..09aeee04cc 100644
--- a/src/frontend/src/components/render/Company.tsx
+++ b/src/frontend/src/components/render/Company.tsx
@@ -50,11 +50,11 @@ export function RenderCompany(
   return (
     <RenderInlineModel
       {...props}
-      image={instance.thumbnail || instance.image}
-      primary={instance.name}
-      suffix={instance.description}
+      image={instance?.thumbnail || instance?.image}
+      primary={instance?.name}
+      suffix={instance?.description}
       url={
-        props.link ? getDetailUrl(ModelType.company, instance.pk) : undefined
+        props.link ? getDetailUrl(ModelType.company, instance?.pk) : undefined
       }
     />
   );
diff --git a/src/frontend/src/pages/build/BuildIndex.tsx b/src/frontend/src/pages/build/BuildIndex.tsx
index 287b1d9cc4..f52441923d 100644
--- a/src/frontend/src/pages/build/BuildIndex.tsx
+++ b/src/frontend/src/pages/build/BuildIndex.tsx
@@ -6,14 +6,16 @@ import {
   IconTable,
   IconTools
 } from '@tabler/icons-react';
-import { useMemo } from 'react';
+import { useCallback, useMemo } from 'react';
 
+import type { EventContentArg } from '@fullcalendar/core';
 import { ModelType, PluginPanelKey } from '@lib/enums/ModelType';
 import { UserRoles } from '@lib/enums/Roles';
 import type { TableFilter } from '@lib/types/Filters';
 import type { PanelType } from '@lib/types/Panel';
 import { useLocalStorage } from '@mantine/hooks';
 import OrderCalendar from '../../components/calendar/OrderCalendar';
+import OrderCalendarToolTip from '../../components/calendar/OrderCalendarToolTip';
 import PermissionDenied from '../../components/errors/PermissionDenied';
 import { PageDetail } from '../../components/nav/PageDetail';
 import { PanelGroup } from '../../components/panels/PanelGroup';
@@ -34,12 +36,21 @@ function BuildOrderCalendar() {
     });
   }, [globalSettings]);
 
+  const renderTooltip = useCallback((event: EventContentArg) => {
+    return OrderCalendarToolTip({
+      event: event,
+      modelType: ModelType.part,
+      instanceLookup: 'part_detail'
+    });
+  }, []);
+
   return (
     <OrderCalendar
       model={ModelType.build}
       role={UserRoles.build}
-      params={{ outstanding: true }}
+      params={{ outstanding: true, part_detail: true }}
       filters={calendarFilters}
+      tooltip={renderTooltip}
     />
   );
 }
diff --git a/src/frontend/src/pages/purchasing/PurchasingIndex.tsx b/src/frontend/src/pages/purchasing/PurchasingIndex.tsx
index 3087c9b530..bdaa271c0e 100644
--- a/src/frontend/src/pages/purchasing/PurchasingIndex.tsx
+++ b/src/frontend/src/pages/purchasing/PurchasingIndex.tsx
@@ -10,13 +10,15 @@ import {
   IconShoppingCart,
   IconTable
 } from '@tabler/icons-react';
-import { useMemo } from 'react';
+import { useCallback, useMemo } from 'react';
 
+import type { EventContentArg } from '@fullcalendar/core';
 import { ModelType, PluginPanelKey } from '@lib/enums/ModelType';
 import { UserRoles } from '@lib/enums/Roles';
 import type { TableFilter } from '@lib/index';
 import { useLocalStorage } from '@mantine/hooks';
 import OrderCalendar from '../../components/calendar/OrderCalendar';
+import OrderCalendarToolTip from '../../components/calendar/OrderCalendarToolTip';
 import PermissionDenied from '../../components/errors/PermissionDenied';
 import { PageDetail } from '../../components/nav/PageDetail';
 import { PanelGroup } from '../../components/panels/PanelGroup';
@@ -37,12 +39,21 @@ function PurchaseOrderCalendar() {
     return PurchaseOrderFilters({ includeDateFilters: false });
   }, []);
 
+  const renderTooltip = useCallback((event: EventContentArg) => {
+    return OrderCalendarToolTip({
+      event: event,
+      modelType: ModelType.company,
+      instanceLookup: 'supplier_detail'
+    });
+  }, []);
+
   return (
     <OrderCalendar
       model={ModelType.purchaseorder}
       role={UserRoles.purchase_order}
-      params={{ outstanding: true }}
+      params={{ outstanding: true, supplier_detail: true }}
       filters={calendarFilters}
+      tooltip={renderTooltip}
     />
   );
 }
diff --git a/src/frontend/src/pages/sales/SalesIndex.tsx b/src/frontend/src/pages/sales/SalesIndex.tsx
index a36fde83da..0f1c0879b0 100644
--- a/src/frontend/src/pages/sales/SalesIndex.tsx
+++ b/src/frontend/src/pages/sales/SalesIndex.tsx
@@ -9,13 +9,15 @@ import {
   IconTruckDelivery,
   IconTruckReturn
 } from '@tabler/icons-react';
-import { useMemo } from 'react';
+import { useCallback, useMemo } from 'react';
 
+import type { EventContentArg } from '@fullcalendar/core';
 import { ModelType, PluginPanelKey } from '@lib/enums/ModelType';
 import { UserRoles } from '@lib/enums/Roles';
 import type { TableFilter } from '@lib/index';
 import { useLocalStorage } from '@mantine/hooks';
 import OrderCalendar from '../../components/calendar/OrderCalendar';
+import OrderCalendarToolTip from '../../components/calendar/OrderCalendarToolTip';
 import PermissionDenied from '../../components/errors/PermissionDenied';
 import { PageDetail } from '../../components/nav/PageDetail';
 import { PanelGroup } from '../../components/panels/PanelGroup';
@@ -35,12 +37,21 @@ function SalesOrderCalendar() {
     return SalesOrderFilters({ includeDateFilters: false });
   }, []);
 
+  const renderTooltip = useCallback((event: EventContentArg) => {
+    return OrderCalendarToolTip({
+      event: event,
+      modelType: ModelType.company,
+      instanceLookup: 'customer_detail'
+    });
+  }, []);
+
   return (
     <OrderCalendar
       model={ModelType.salesorder}
       role={UserRoles.sales_order}
-      params={{ outstanding: true }}
+      params={{ outstanding: true, customer_detail: true }}
       filters={calendarFilters}
+      tooltip={renderTooltip}
     />
   );
 }
@@ -50,12 +61,21 @@ const ReturnOrderCalendar = () => {
     return SalesOrderFilters({ includeDateFilters: false });
   }, []);
 
+  const renderTooltip = useCallback((event: EventContentArg) => {
+    return OrderCalendarToolTip({
+      event: event,
+      modelType: ModelType.company,
+      instanceLookup: 'customer_detail'
+    });
+  }, []);
+
   return (
     <OrderCalendar
       model={ModelType.returnorder}
       role={UserRoles.return_order}
-      params={{ outstanding: true }}
+      params={{ outstanding: true, customer_detail: true }}
       filters={calendarFilters}
+      tooltip={renderTooltip}
     />
   );
 };
diff --git a/src/frontend/src/tables/InvenTreeTableHeader.tsx b/src/frontend/src/tables/InvenTreeTableHeader.tsx
index 612b6ba06d..2defcb7a22 100644
--- a/src/frontend/src/tables/InvenTreeTableHeader.tsx
+++ b/src/frontend/src/tables/InvenTreeTableHeader.tsx
@@ -276,6 +276,7 @@ export default function InvenTreeTableHeader({
                         <Divider />
                         {tableState.filterSet.activeFilters?.map((filter) => (
                           <FilterPreview
+                            key={filter.name}
                             filter={filter}
                             filters={tableProps.tableFilters}
                           />

From 65d15a59451858221ba13a035c476be48c2c8b3a Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Fri, 22 May 2026 08:19:01 +1000
Subject: [PATCH 02/10] chore(deps): bump idna from 3.13 to 3.15 in
 /contrib/dev_reqs (#11970)

* chore(deps): bump idna from 3.13 to 3.15 in /contrib/dev_reqs

Bumps [idna](https://github.com/kjd/idna) from 3.13 to 3.15.
- [Release notes](https://github.com/kjd/idna/releases)
- [Changelog](https://github.com/kjd/idna/blob/master/HISTORY.md)
- [Commits](https://github.com/kjd/idna/compare/v3.13...v3.15)

---
updated-dependencies:
- dependency-name: idna
  dependency-version: '3.15'
  dependency-type: indirect
...

Signed-off-by: dependabot[bot] <support@github.com>

* fix style

---------

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Matthias Mair <code@mjmair.com>
---
 contrib/dev_reqs/requirements.txt     | 6 +++---
 docs/requirements.txt                 | 6 +++---
 src/backend/requirements-3.14.txt     | 6 +++---
 src/backend/requirements-dev-3.14.txt | 6 +++---
 src/backend/requirements-dev.txt      | 6 +++---
 src/backend/requirements.txt          | 6 +++---
 6 files changed, 18 insertions(+), 18 deletions(-)

diff --git a/contrib/dev_reqs/requirements.txt b/contrib/dev_reqs/requirements.txt
index a783698ee4..0591b6d8a6 100644
--- a/contrib/dev_reqs/requirements.txt
+++ b/contrib/dev_reqs/requirements.txt
@@ -139,9 +139,9 @@ charset-normalizer==3.4.7 \
     # via
     #   -c src/backend/requirements.txt
     #   requests
-idna==3.13 \
-    --hash=sha256:585ea8fe5d69b9181ec1afba340451fba6ba764af97026f92a91d4eef164a242 \
-    --hash=sha256:892ea0cde124a99ce773decba204c5552b69c3c67ffd5f232eb7696135bc8bb3
+idna==3.15 \
+    --hash=sha256:048adeaf8c2d788c40fee287673ccaa74c24ffd8dcf09ffa555a2fbb59f10ac8 \
+    --hash=sha256:ca962446ea538f7092a95e057da437618e886f4d349216d2b1e294abfdb65fdc
     # via
     #   -c src/backend/requirements.txt
     #   requests
diff --git a/docs/requirements.txt b/docs/requirements.txt
index df1b00c4a1..4248102d6e 100644
--- a/docs/requirements.txt
+++ b/docs/requirements.txt
@@ -227,9 +227,9 @@ httpx==0.28.1 \
     --hash=sha256:75e98c5f16b0f35b567856f597f06ff2270a374470a5c2392242528e3e3e42fc \
     --hash=sha256:d909fcccc110f8c7faf814ca82a9a4d816bc5a6dbfea25d6591d6985b8ba59ad
     # via neoteroi-mkdocs
-idna==3.13 \
-    --hash=sha256:585ea8fe5d69b9181ec1afba340451fba6ba764af97026f92a91d4eef164a242 \
-    --hash=sha256:892ea0cde124a99ce773decba204c5552b69c3c67ffd5f232eb7696135bc8bb3
+idna==3.15 \
+    --hash=sha256:048adeaf8c2d788c40fee287673ccaa74c24ffd8dcf09ffa555a2fbb59f10ac8 \
+    --hash=sha256:ca962446ea538f7092a95e057da437618e886f4d349216d2b1e294abfdb65fdc
     # via
     #   -c src/backend/requirements.txt
     #   anyio
diff --git a/src/backend/requirements-3.14.txt b/src/backend/requirements-3.14.txt
index c331b69655..96528aea96 100644
--- a/src/backend/requirements-3.14.txt
+++ b/src/backend/requirements-3.14.txt
@@ -977,9 +977,9 @@ icalendar==7.0.3 \
     # via
     #   -c src/backend/requirements.txt
     #   django-ical
-idna==3.13 \
-    --hash=sha256:585ea8fe5d69b9181ec1afba340451fba6ba764af97026f92a91d4eef164a242 \
-    --hash=sha256:892ea0cde124a99ce773decba204c5552b69c3c67ffd5f232eb7696135bc8bb3
+idna==3.15 \
+    --hash=sha256:048adeaf8c2d788c40fee287673ccaa74c24ffd8dcf09ffa555a2fbb59f10ac8 \
+    --hash=sha256:ca962446ea538f7092a95e057da437618e886f4d349216d2b1e294abfdb65fdc
     # via
     #   -c src/backend/requirements.txt
     #   django-anymail
diff --git a/src/backend/requirements-dev-3.14.txt b/src/backend/requirements-dev-3.14.txt
index 9c7503d9dc..a0f377ed8f 100644
--- a/src/backend/requirements-dev-3.14.txt
+++ b/src/backend/requirements-dev-3.14.txt
@@ -449,9 +449,9 @@ gprof2dot==2025.4.14 \
     --hash=sha256:0742e4c0b4409a5e8777e739388a11e1ed3750be86895655312ea7c20bd0090e \
     --hash=sha256:35743e2d2ca027bf48fa7cba37021aaf4a27beeae1ae8e05a50b55f1f921a6ce
     # via django-silk
-idna==3.13 \
-    --hash=sha256:585ea8fe5d69b9181ec1afba340451fba6ba764af97026f92a91d4eef164a242 \
-    --hash=sha256:892ea0cde124a99ce773decba204c5552b69c3c67ffd5f232eb7696135bc8bb3
+idna==3.15 \
+    --hash=sha256:048adeaf8c2d788c40fee287673ccaa74c24ffd8dcf09ffa555a2fbb59f10ac8 \
+    --hash=sha256:ca962446ea538f7092a95e057da437618e886f4d349216d2b1e294abfdb65fdc
     # via
     #   -c src/backend/requirements-3.14.txt
     #   -c src/backend/requirements.txt
diff --git a/src/backend/requirements-dev.txt b/src/backend/requirements-dev.txt
index 9aa16fb90e..cdb18aede7 100644
--- a/src/backend/requirements-dev.txt
+++ b/src/backend/requirements-dev.txt
@@ -443,9 +443,9 @@ gprof2dot==2025.4.14 \
     --hash=sha256:0742e4c0b4409a5e8777e739388a11e1ed3750be86895655312ea7c20bd0090e \
     --hash=sha256:35743e2d2ca027bf48fa7cba37021aaf4a27beeae1ae8e05a50b55f1f921a6ce
     # via django-silk
-idna==3.13 \
-    --hash=sha256:585ea8fe5d69b9181ec1afba340451fba6ba764af97026f92a91d4eef164a242 \
-    --hash=sha256:892ea0cde124a99ce773decba204c5552b69c3c67ffd5f232eb7696135bc8bb3
+idna==3.15 \
+    --hash=sha256:048adeaf8c2d788c40fee287673ccaa74c24ffd8dcf09ffa555a2fbb59f10ac8 \
+    --hash=sha256:ca962446ea538f7092a95e057da437618e886f4d349216d2b1e294abfdb65fdc
     # via
     #   -c src/backend/requirements.txt
     #   requests
diff --git a/src/backend/requirements.txt b/src/backend/requirements.txt
index d515cb039e..2d730180a4 100644
--- a/src/backend/requirements.txt
+++ b/src/backend/requirements.txt
@@ -868,9 +868,9 @@ icalendar==7.0.3 \
     --hash=sha256:8c9fea6d3a89671bba8b6938d8565b4d0ec465c6a2796ef0f92790dcb9e627cd \
     --hash=sha256:95027ece087ab87184d765f03761f25875821f74cdd18d3b57e9c868216d8fde
     # via django-ical
-idna==3.13 \
-    --hash=sha256:585ea8fe5d69b9181ec1afba340451fba6ba764af97026f92a91d4eef164a242 \
-    --hash=sha256:892ea0cde124a99ce773decba204c5552b69c3c67ffd5f232eb7696135bc8bb3
+idna==3.15 \
+    --hash=sha256:048adeaf8c2d788c40fee287673ccaa74c24ffd8dcf09ffa555a2fbb59f10ac8 \
+    --hash=sha256:ca962446ea538f7092a95e057da437618e886f4d349216d2b1e294abfdb65fdc
     # via
     #   django-anymail
     #   requests

From f27b9b5443af0a99f87066547c80fea3be652b0f Mon Sep 17 00:00:00 2001
From: Matthias Mair <code@mjmair.com>
Date: Fri, 22 May 2026 00:20:07 +0200
Subject: [PATCH 03/10] feat(frontend): Add option for plugins to add header
 actions (#9570)

* [FR] PUI - Add option for plugins to add header actions
Fixes #8593

* fix parsing

* fix merge

* reduce diff

* fix sample implementation

* add support for icons and colors in primary actions

* add changelog entry

* add docs

* add more detailed sample text

* pass location into context

* fix test

---------

Co-authored-by: Oliver <oliver.henry.walters@gmail.com>
---
 CHANGELOG.md                                  |  1 +
 docs/docs/plugins/mixins/ui.md                | 14 ++++++
 .../InvenTree/plugin/base/ui/mixins.py        | 28 ++++++++++++
 src/backend/InvenTree/plugin/base/ui/tests.py | 10 +++++
 .../integration/user_interface_sample.py      | 11 +++++
 .../buttons/PrimaryActionButton.tsx           |  6 ++-
 .../src/components/nav/PageDetail.tsx         | 44 ++++++++++++++++++-
 .../components/plugins/PluginUIFeature.tsx    |  3 +-
 .../plugins/PluginUIFeatureTypes.ts           |  8 ++++
 src/frontend/tests/pages/pui_stock.spec.ts    |  7 +--
 10 files changed, 122 insertions(+), 10 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index a8724e2ec4..8d8169854f 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -23,6 +23,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - [#11778](https://github.com/inventree/InvenTree/pull/11778) adds inline supplier part creation to po line item addition dialog.
 - [#11772](https://github.com/inventree/InvenTree/pull/11772) the UI now warns if you navigate away from a note panel with unsaved changes
 - [#11788](https://github.com/inventree/InvenTree/pull/11788) adds support for custom permissions checks on database models defined in plugins. If a model defines a `check_user_permission` classmethod, this will be called to determine if a user has permission to view the model. This is required for plugin models which do not have the required ruleset definitions for the standard permission system.
+- [#9570](https://github.com/inventree/InvenTree/pull/9570) adds support for defining primary actions via plugins
 
 ### Changed
 
diff --git a/docs/docs/plugins/mixins/ui.md b/docs/docs/plugins/mixins/ui.md
index 90329832c2..dc3785d778 100644
--- a/docs/docs/plugins/mixins/ui.md
+++ b/docs/docs/plugins/mixins/ui.md
@@ -183,6 +183,20 @@ The `get_ui_template_previews` feature type can be used to provide custom templa
       summary: False
       members: []
 
+### Primary Actions
+
+The `get_ui_primary_actions` method can be used to provide custom primary action, which are rendered in the header of the page, next to the title/name and any status indicators. These primary actions are typically used to provide quick access to common actions related to the current page.
+
+::: plugin.base.ui.mixins.UserInterfaceMixin.get_ui_primary_actions
+    options:
+      show_bases: False
+      show_root_heading: False
+      show_root_toc_entry: False
+      extra:
+        show_source: True
+      summary: False
+      members: []
+
 ## Plugin Context
 
 When rendering certain content in the user interface, the rendering functions are passed a `context` object which contains information about the current page being rendered. The type of the `context` object is defined in the `PluginContext` file:
diff --git a/src/backend/InvenTree/plugin/base/ui/mixins.py b/src/backend/InvenTree/plugin/base/ui/mixins.py
index 4ab84ef6ca..9aa4a67edd 100644
--- a/src/backend/InvenTree/plugin/base/ui/mixins.py
+++ b/src/backend/InvenTree/plugin/base/ui/mixins.py
@@ -21,6 +21,7 @@ FeatureType = Literal[
     'template_editor',  # Custom template editor
     'template_preview',  # Custom template preview
     'navigation',  # Custom navigation items
+    'primary_action',  # Custom primary action buttons
 ]
 
 
@@ -106,6 +107,7 @@ class UserInterfaceMixin:
             'panel': self.get_ui_panels,
             'template_editor': self.get_ui_template_editors,
             'template_preview': self.get_ui_template_previews,
+            'primary_action': self.get_ui_primary_actions,
         }
 
         if feature_type in feature_map:
@@ -203,3 +205,29 @@ class UserInterfaceMixin:
         """
         # Default implementation returns an empty list
         return []
+
+    def get_ui_primary_actions(
+        self, request: Request, context: dict, **kwargs
+    ) -> list[UIFeature]:
+        """Return a list of custom primary action buttons to be injected into the UI.
+
+        Args:
+            request: HTTPRequest object (including user information)
+            context: Additional context data provided by the UI (query parameters)
+
+        Returns:
+            list: A list of custom primary action buttons to be injected into the UI
+        """
+        # Sample code to render conditional primary action button based on context
+        # items = []
+        # if self.my_assert_function(context):
+        #     items.append({
+        #         'key': 'sample-primary-action',
+        #         'title': 'Sample Primary Action',
+        #         'icon': 'ti:plus:outline',
+        #         'options': {'url': '/core/sample-primary-action/', 'color': 'orange'},
+        #     })
+        # return items
+
+        # Default implementation returns an empty list
+        return []
diff --git a/src/backend/InvenTree/plugin/base/ui/tests.py b/src/backend/InvenTree/plugin/base/ui/tests.py
index e38e64a856..0a4a94977b 100644
--- a/src/backend/InvenTree/plugin/base/ui/tests.py
+++ b/src/backend/InvenTree/plugin/base/ui/tests.py
@@ -233,3 +233,13 @@ class UserInterfaceMixinTests(InvenTreeAPITestCase):
         self.assertEqual(response.data[0]['plugin_name'], 'sampleui')
         self.assertEqual(response.data[0]['key'], 'sample-nav-item')
         self.assertEqual(response.data[0]['title'], 'Sample Nav Item')
+
+    def test_ui_primary_actions(self):
+        """Test that the sample UI plugin provides custom primary actions."""
+        response = self.get(
+            reverse('api-plugin-ui-feature-list', kwargs={'feature': 'primary_action'})
+        )
+        self.assertEqual(1, len(response.data))
+        self.assertEqual(response.data[0]['plugin_name'], 'sampleui')
+        self.assertEqual(response.data[0]['key'], 'sample-primary-action')
+        self.assertEqual(response.data[0]['title'], 'Sample Primary Action')
diff --git a/src/backend/InvenTree/plugin/samples/integration/user_interface_sample.py b/src/backend/InvenTree/plugin/samples/integration/user_interface_sample.py
index 70c47f220a..09bdbb7f37 100644
--- a/src/backend/InvenTree/plugin/samples/integration/user_interface_sample.py
+++ b/src/backend/InvenTree/plugin/samples/integration/user_interface_sample.py
@@ -226,6 +226,17 @@ class SampleUserInterfacePlugin(SettingsMixin, UserInterfaceMixin, InvenTreePlug
             }
         ]
 
+    def get_ui_primary_actions(self, request, context, **kwargs):
+        """Return a list of custom primary action buttons."""
+        return [
+            {
+                'key': 'sample-primary-action',
+                'title': 'Sample Primary Action',
+                'icon': 'ti:plus:outline',
+                'options': {'url': '/core/sample-primary-action/', 'color': 'orange'},
+            }
+        ]
+
     def get_admin_context(self) -> dict:
         """Return custom context data which can be rendered in the admin panel."""
         return {'apple': 'banana', 'foo': 'bar', 'hello': 'world'}
diff --git a/src/frontend/src/components/buttons/PrimaryActionButton.tsx b/src/frontend/src/components/buttons/PrimaryActionButton.tsx
index 275fd21379..293d3b0b8b 100644
--- a/src/frontend/src/components/buttons/PrimaryActionButton.tsx
+++ b/src/frontend/src/components/buttons/PrimaryActionButton.tsx
@@ -12,7 +12,8 @@ export default function PrimaryActionButton({
   icon,
   color,
   hidden,
-  onClick
+  onClick,
+  leftSection
 }: Readonly<{
   title: string;
   tooltip?: string;
@@ -20,6 +21,7 @@ export default function PrimaryActionButton({
   color?: string;
   hidden?: boolean;
   onClick: () => void;
+  leftSection?: React.ReactNode;
 }>) {
   if (hidden) {
     return null;
@@ -28,7 +30,7 @@ export default function PrimaryActionButton({
   return (
     <Tooltip label={tooltip ?? title} position='bottom' hidden={!tooltip}>
       <Button
-        leftSection={icon && <InvenTreeIcon icon={icon} />}
+        leftSection={leftSection ?? (icon && <InvenTreeIcon icon={icon} />)}
         color={color}
         radius='sm'
         p='xs'
diff --git a/src/frontend/src/components/nav/PageDetail.tsx b/src/frontend/src/components/nav/PageDetail.tsx
index d8cbb6b167..65754bdd98 100644
--- a/src/frontend/src/components/nav/PageDetail.tsx
+++ b/src/frontend/src/components/nav/PageDetail.tsx
@@ -4,8 +4,13 @@ import { useHotkeys } from '@mantine/hooks';
 import { StylishText } from '@lib/components/StylishText';
 import { shortenString } from '@lib/functions/String';
 import { Fragment, type ReactNode, useMemo } from 'react';
+import { useLocation, useNavigate } from 'react-router-dom';
+import { usePluginUIFeature } from '../../hooks/UsePluginUIFeature';
 import { useUserSettingsState } from '../../states/SettingsStates';
+import PrimaryActionButton from '../buttons/PrimaryActionButton';
 import { ApiImage } from '../images/ApiImage';
+import { ApiIcon } from '../items/ApiIcon';
+import type { PrimaryActionUIFeature } from '../plugins/PluginUIFeatureTypes';
 import { type Breadcrumb, BreadcrumbList } from './BreadcrumbList';
 import PageTitle from './PageTitle';
 
@@ -45,6 +50,8 @@ export function PageDetail({
   editEnabled
 }: Readonly<PageDetailInterface>) {
   const userSettings = useUserSettingsState();
+  const navigate = useNavigate();
+  const location = useLocation();
   useHotkeys([
     [
       'mod+E',
@@ -86,6 +93,39 @@ export function PageDetail({
     }
   }, [breadcrumbs, last_crumb, userSettings]);
 
+  const extraActions = usePluginUIFeature<PrimaryActionUIFeature>({
+    featureType: 'primary_action',
+    context: { location: location.pathname }
+  });
+
+  // action caching
+  const computedActions = useMemo(() => {
+    const extraActionArray: ReactNode[] = extraActions.map((action) => {
+      const { options: opts, func } = action;
+      const { title, icon, context, options } = opts;
+
+      const click = () => {
+        const url = options?.url;
+        if (url) {
+          navigate(url);
+        } else if (func) {
+          func(context);
+        }
+      };
+
+      return (
+        <PrimaryActionButton
+          title={title}
+          leftSection={<ApiIcon name={icon as string} />}
+          color={options?.color}
+          onClick={click}
+          key={title}
+        />
+      );
+    });
+    return [...(extraActionArray ?? []), ...(actions ?? [])];
+  }, [extraActions, actions]);
+
   return (
     <>
       <PageTitle title={pageTitleString} />
@@ -140,9 +180,9 @@ export function PageDetail({
                 </Group>
               )}
             </Group>
-            {actions && (
+            {computedActions && (
               <Group gap={5} justify='right' wrap='nowrap' align='flex-start'>
-                {actions.map((action, idx) => (
+                {computedActions.map((action, idx) => (
                   <Fragment key={idx}>{action}</Fragment>
                 ))}
               </Group>
diff --git a/src/frontend/src/components/plugins/PluginUIFeature.tsx b/src/frontend/src/components/plugins/PluginUIFeature.tsx
index cb11faa981..85425d4894 100644
--- a/src/frontend/src/components/plugins/PluginUIFeature.tsx
+++ b/src/frontend/src/components/plugins/PluginUIFeature.tsx
@@ -30,7 +30,8 @@ export enum PluginUIFeatureType {
   panel = 'panel',
   template_editor = 'template_editor',
   template_preview = 'template_preview',
-  navigation = 'navigation'
+  navigation = 'navigation',
+  primary_action = 'primary_action'
 }
 
 /**
diff --git a/src/frontend/src/components/plugins/PluginUIFeatureTypes.ts b/src/frontend/src/components/plugins/PluginUIFeatureTypes.ts
index 99b839fa31..5da52b90ac 100644
--- a/src/frontend/src/components/plugins/PluginUIFeatureTypes.ts
+++ b/src/frontend/src/components/plugins/PluginUIFeatureTypes.ts
@@ -84,3 +84,11 @@ export type NavigationUIFeature = {
   featureContext: {};
   featureReturnType: undefined;
 };
+
+export type PrimaryActionUIFeature = {
+  featureType: 'primary_action';
+  requestContext: {};
+  responseOptions: PluginUIFeature;
+  featureContext: {};
+  featureReturnType: undefined;
+};
diff --git a/src/frontend/tests/pages/pui_stock.spec.ts b/src/frontend/tests/pages/pui_stock.spec.ts
index eef8ee935c..07d613debe 100644
--- a/src/frontend/tests/pages/pui_stock.spec.ts
+++ b/src/frontend/tests/pages/pui_stock.spec.ts
@@ -100,11 +100,8 @@ test('Stock - Location Delete', async ({ browser }) => {
 
   // Delete this location, and all child locations
   await page
-    .locator('div')
-    .filter({
-      hasText: new RegExp(`^Stock>PCB Assembler>${loc_1}Stock Location$`)
-    })
-    .getByLabel('action-menu-location-actions')
+    .getByRole('button', { name: 'action-menu-location-actions' })
+    .first()
     .click();
   await page
     .getByRole('menuitem', { name: 'action-menu-location-actions-delete' })

From 9908870a81ee3036d7217797c2cf38ccd477e25f Mon Sep 17 00:00:00 2001
From: Matthias Mair <code@mjmair.com>
Date: Fri, 22 May 2026 01:44:24 +0200
Subject: [PATCH 04/10] realign user API endpoints (#11963)

* realign user API endpoints to make it clearer which one are only applicable to the current user

* fix name

* bump api

* fix test

* fix reference

* fix test exception

* update ref

* reduce breakage

* re-add legacy urls till next `breaking`
---
 CHANGELOG.md                                  |  1 +
 docs/docs/api/index.md                        |  4 +-
 .../InvenTree/InvenTree/api_version.py        |  5 ++-
 src/backend/InvenTree/InvenTree/schema.py     | 21 +++++++++++
 src/backend/InvenTree/users/api.py            | 37 +++++++++++++++++--
 src/frontend/lib/enums/ApiEndpoints.tsx       |  9 +++--
 .../AccountSettings/AccountDetailPanel.tsx    |  2 +-
 src/frontend/src/states/LocalState.tsx        |  2 +-
 src/frontend/src/states/UserState.tsx         |  2 +-
 .../src/tables/settings/ApiTokenTable.tsx     |  2 +-
 src/frontend/tests/baseFixtures.ts            |  2 +-
 .../tests/pages/pui_dashboard.spec.ts         |  2 +-
 12 files changed, 72 insertions(+), 17 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 8d8169854f..c035158ae0 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -9,6 +9,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Breaking Changes
 
+- [#9604](https://github.com/inventree/InvenTree/pull/9604) - refactors user API endpoint to be less ambiguous
 - [#11893](https://github.com/inventree/InvenTree/pull/11893) bumps Node environment to version 24 LTS - this is only relevant if you build the frontend assets yourself
 
 ### Added
diff --git a/docs/docs/api/index.md b/docs/docs/api/index.md
index 58c21fa947..256eddd9cf 100644
--- a/docs/docs/api/index.md
+++ b/docs/docs/api/index.md
@@ -54,7 +54,7 @@ Each user is assigned an authentication token which can be used to access the AP
 
 If a user does not know their access token, it can be requested via the API interface itself, using a basic authentication request.
 
-To obtain a valid token, perform a GET request to `/api/user/token/`. No data are required, but a valid username / password combination must be supplied in the authentication headers.
+To obtain a valid token, perform a GET request to `/api/user/me/token/`. No data are required, but a valid username / password combination must be supplied in the authentication headers.
 
 !!! info "Credentials"
 	Ensure that a valid username:password combination are supplied as basic authorization headers.
@@ -146,7 +146,7 @@ r:delete:stock
 Users can only perform REST API actions which align with their assigned [role permissions](../settings/permissions.md#roles).
 Once a user has *authenticated* via the API, a list of the available roles can be retrieved from:
 
-`/api/user/roles/`
+`/api/user/me/roles/`
 
 For example, when accessing the API from a *superuser* account:
 
diff --git a/src/backend/InvenTree/InvenTree/api_version.py b/src/backend/InvenTree/InvenTree/api_version.py
index dc17ef357a..2de7bf0df3 100644
--- a/src/backend/InvenTree/InvenTree/api_version.py
+++ b/src/backend/InvenTree/InvenTree/api_version.py
@@ -1,11 +1,14 @@
 """InvenTree API version information."""
 
 # InvenTree API version
-INVENTREE_API_VERSION = 489
+INVENTREE_API_VERSION = 490
 """Increment this API version number whenever there is a significant change to the API that any clients need to know about."""
 
 INVENTREE_API_TEXT = """
 
+v490 -> 2026-05-19 : https://github.com/inventree/InvenTree/pull/11963
+    - moves user-self-filtered endpoints to /user/me/ to make their security boundaries clearer
+
 v489 -> 2026-05-18 : https://github.com/inventree/InvenTree/pull/11962
     - Removes the "remote_image" field from the Part API endpoint
     - Removes the "remote_image" field from the Company API endpoint
diff --git a/src/backend/InvenTree/InvenTree/schema.py b/src/backend/InvenTree/InvenTree/schema.py
index 93050be7ce..55fa008349 100644
--- a/src/backend/InvenTree/InvenTree/schema.py
+++ b/src/backend/InvenTree/InvenTree/schema.py
@@ -341,3 +341,24 @@ def schema_for_view_output_options(view_class):
         view_class
     )
     return extended_view
+
+
+def exclude_from_schema(klass: type, alternative_path: str) -> type:
+    """Decorator to exclude a view from the OpenAPI schema.
+
+    This is used to hide legacy endpoints from the schema, while still retaining them for backwards compatibility.
+    """
+
+    class LegacyView(klass):
+        """Dummy doc."""
+
+    LegacyView.__name__ = klass.__name__ + ' - Legacy'
+    LegacyView.__doc__ = f'This is a legacy endpoint, retained for backwards compatibility. Consider migrating to the new endpoint under {alternative_path}.'
+
+    # Exclude all default operations from the schema
+    for operation in ['get', 'post', 'put', 'patch', 'delete']:
+        if hasattr(klass, operation):
+            LegacyView = extend_schema_view(**{operation: extend_schema(exclude=True)})(
+                LegacyView
+            )
+    return LegacyView
diff --git a/src/backend/InvenTree/users/api.py b/src/backend/InvenTree/users/api.py
index 6e07f35c77..13ef2fa501 100644
--- a/src/backend/InvenTree/users/api.py
+++ b/src/backend/InvenTree/users/api.py
@@ -33,6 +33,7 @@ from InvenTree.mixins import (
     SerializerContextMixin,
     UpdateAPI,
 )
+from InvenTree.schema import exclude_from_schema
 from InvenTree.settings import FRONTEND_URL_BASE
 from users.models import ApiToken, Owner, RuleSet, UserProfile
 from users.serializers import (
@@ -501,8 +502,38 @@ class UserProfileDetail(RetrieveUpdateAPI):
 
 
 user_urls = [
-    path('roles/', RoleDetails.as_view(), name='api-user-roles'),
-    path('token/', ensure_csrf_cookie(GetAuthToken.as_view()), name='api-token'),
+    # Legacy endpoints (to avoid breaking existing API clients)
+    # TODO @matmair - remove these legacy endpoints in the next breaking release
+    path(
+        'roles/',
+        exclude_from_schema(RoleDetails, '/api/user/me/roles/').as_view(),
+        name='api-user-roles_legacy',
+    ),
+    path(
+        'token/',
+        ensure_csrf_cookie(
+            exclude_from_schema(GetAuthToken, '/api/user/me/token/').as_view()
+        ),
+        name='api-token_legacy',
+    ),
+    path(
+        'profile/',
+        exclude_from_schema(UserProfileDetail, '/api/user/me/profile/').as_view(),
+        name='api-user-profile_legacy',
+    ),
+    # Individual user endpoints
+    path(
+        'me/',
+        include([
+            path('profile/', UserProfileDetail.as_view(), name='api-user-profile'),
+            path('roles/', RoleDetails.as_view(), name='api-user-roles'),
+            path(
+                'token/', ensure_csrf_cookie(GetAuthToken.as_view()), name='api-token'
+            ),
+            path('', MeUserDetail.as_view(), name='api-user-me'),
+        ]),
+    ),
+    # User related endpoints
     path(
         'tokens/',
         include([
@@ -510,8 +541,6 @@ user_urls = [
             path('', TokenListView.as_view(), name='api-token-list'),
         ]),
     ),
-    path('me/', MeUserDetail.as_view(), name='api-user-me'),
-    path('profile/', UserProfileDetail.as_view(), name='api-user-profile'),
     path(
         'owner/',
         include([
diff --git a/src/frontend/lib/enums/ApiEndpoints.tsx b/src/frontend/lib/enums/ApiEndpoints.tsx
index addb35378b..bc06ace42c 100644
--- a/src/frontend/lib/enums/ApiEndpoints.tsx
+++ b/src/frontend/lib/enums/ApiEndpoints.tsx
@@ -12,12 +12,13 @@ export enum ApiEndpoints {
   // User API endpoints
   user_list = 'user/',
   user_set_password = 'user/:id/set-password/',
-  user_me = 'user/me/',
-  user_profile = 'user/profile/',
-  user_roles = 'user/roles/',
-  user_token = 'user/token/',
   user_tokens = 'user/tokens/',
   user_simple_login = 'email/generate/',
+  // Individual user endpoints
+  user_me_profile = 'user/me/profile/',
+  user_me_roles = 'user/me/roles/',
+  user_me_token = 'user/me/token/',
+  user_me = 'user/me/',
 
   // User auth endpoints
   auth_base = '/auth/',
diff --git a/src/frontend/src/pages/Index/Settings/AccountSettings/AccountDetailPanel.tsx b/src/frontend/src/pages/Index/Settings/AccountSettings/AccountDetailPanel.tsx
index bc8045b4ce..16bd567bd5 100644
--- a/src/frontend/src/pages/Index/Settings/AccountSettings/AccountDetailPanel.tsx
+++ b/src/frontend/src/pages/Index/Settings/AccountSettings/AccountDetailPanel.tsx
@@ -53,7 +53,7 @@ export function AccountDetailPanel() {
 
   const editProfile = useEditApiFormModal({
     title: t`Edit Profile Information`,
-    url: ApiEndpoints.user_profile,
+    url: ApiEndpoints.user_me_profile,
     onFormSuccess: fetchUserState,
     fields: profileFields,
     successMessage: t`Profile details updated`
diff --git a/src/frontend/src/states/LocalState.tsx b/src/frontend/src/states/LocalState.tsx
index d0d7aceaac..f5c09b0751 100644
--- a/src/frontend/src/states/LocalState.tsx
+++ b/src/frontend/src/states/LocalState.tsx
@@ -154,7 +154,7 @@ pushes changes in user profile to backend
 export function patchUser(key: 'language' | 'theme' | 'widgets', val: any) {
   const uid = useUserState.getState().userId();
   if (uid) {
-    api.patch(apiUrl(ApiEndpoints.user_profile), { [key]: val });
+    api.patch(apiUrl(ApiEndpoints.user_me_profile), { [key]: val });
   } else {
     console.log('user not logged in, not patching');
   }
diff --git a/src/frontend/src/states/UserState.tsx b/src/frontend/src/states/UserState.tsx
index 16cfd75bde..f6e309861a 100644
--- a/src/frontend/src/states/UserState.tsx
+++ b/src/frontend/src/states/UserState.tsx
@@ -104,7 +104,7 @@ export const useUserState = create<UserStateProps>((set, get) => ({
 
     // Fetch role data
     await api
-      .get(apiUrl(ApiEndpoints.user_roles))
+      .get(apiUrl(ApiEndpoints.user_me_roles))
       .then((response) => {
         if (response.status == 200) {
           const user: UserProps = get().user as UserProps;
diff --git a/src/frontend/src/tables/settings/ApiTokenTable.tsx b/src/frontend/src/tables/settings/ApiTokenTable.tsx
index 14d4bcda8a..ead1d0b50d 100644
--- a/src/frontend/src/tables/settings/ApiTokenTable.tsx
+++ b/src/frontend/src/tables/settings/ApiTokenTable.tsx
@@ -26,7 +26,7 @@ export function ApiTokenTable({
   const [opened, { open, close }] = useDisclosure(false);
 
   const generateToken = useCreateApiFormModal({
-    url: ApiEndpoints.user_token,
+    url: ApiEndpoints.user_me_token,
     method: 'GET',
     title: t`Generate Token`,
     fields: { name: {} },
diff --git a/src/frontend/tests/baseFixtures.ts b/src/frontend/tests/baseFixtures.ts
index d181a882ac..66bd836008 100644
--- a/src/frontend/tests/baseFixtures.ts
+++ b/src/frontend/tests/baseFixtures.ts
@@ -70,7 +70,7 @@ export const test = baseTest.extend({
         !msg.text().includes('/this/does/not/exist.js') &&
         !url.includes('/this/does/not/exist.js') &&
         !url.includes('/api/user/me/') &&
-        !url.includes('/api/user/token/') &&
+        !url.includes('/api/user/me/token/') &&
         !url.includes('/api/auth/v1/auth/login') &&
         !url.includes('/api/auth/v1/auth/session') &&
         !url.includes('/api/auth/v1/account/authenticators/totp') &&
diff --git a/src/frontend/tests/pages/pui_dashboard.spec.ts b/src/frontend/tests/pages/pui_dashboard.spec.ts
index 07af2a5a0b..eca6c9a004 100644
--- a/src/frontend/tests/pages/pui_dashboard.spec.ts
+++ b/src/frontend/tests/pages/pui_dashboard.spec.ts
@@ -142,7 +142,7 @@ test('Dashboard - Preserve widget sizes', async ({ browser }) => {
     password: user.testcred
   });
 
-  (await api).patch('user/profile/', {
+  (await api).patch('user/me/profile/', {
     data: {
       widgets: {
         widgets: ['ovr-so'],

From 8b9ea43b5bd99372946d8844933583ea19dd1437 Mon Sep 17 00:00:00 2001
From: Oliver <oliver.henry.walters@gmail.com>
Date: Fri, 22 May 2026 10:21:23 +1000
Subject: [PATCH 05/10] [UI] Lock action (#11981)

- Toggle part lock directly from existing icon
---
 src/frontend/src/pages/part/PartDetail.tsx | 18 +++++++++++++++---
 1 file changed, 15 insertions(+), 3 deletions(-)

diff --git a/src/frontend/src/pages/part/PartDetail.tsx b/src/frontend/src/pages/part/PartDetail.tsx
index 62742ddaf6..209711b9b2 100644
--- a/src/frontend/src/pages/part/PartDetail.tsx
+++ b/src/frontend/src/pages/part/PartDetail.tsx
@@ -23,6 +23,7 @@ import {
   IconListDetails,
   IconListTree,
   IconLock,
+  IconLockOpen,
   IconPackages,
   IconSearch,
   IconShoppingCart,
@@ -1132,9 +1133,20 @@ export default function PartDetail() {
           <PageDetail
             title={`${t`Part`}: ${part.full_name}`}
             icon={
-              part?.locked ? (
-                <IconLock aria-label='part-lock-icon' />
-              ) : undefined
+              <ActionIcon
+                aria-label='part-lock-icon'
+                variant='transparent'
+                disabled={!user.hasChangeRole(UserRoles.part)}
+                onClick={() => {
+                  api
+                    .patch(apiUrl(ApiEndpoints.part_list, part.pk), {
+                      locked: !part.locked
+                    })
+                    .then(refreshInstance);
+                }}
+              >
+                {part?.locked ? <IconLock /> : <IconLockOpen />}
+              </ActionIcon>
             }
             subtitle={part.description}
             imageUrl={part.image}

From 8ae0a5ea66004d292c1472bbcd9f2abade4404da Mon Sep 17 00:00:00 2001
From: Oliver <oliver.henry.walters@gmail.com>
Date: Fri, 22 May 2026 14:37:36 +1000
Subject: [PATCH 06/10] Tree delete API (#11979)

* Add API serializer for deleting a location

* Add serializer for part category delete

* Bump API version

* Fix unit tests

---------

Co-authored-by: Matthias Mair <code@mjmair.com>
---
 .../InvenTree/InvenTree/api_version.py        |   6 +-
 src/backend/InvenTree/part/api.py             |   7 +-
 src/backend/InvenTree/part/serializers.py     |  21 ++
 src/backend/InvenTree/part/test_api.py        | 173 ++++++++---------
 src/backend/InvenTree/stock/api.py            |   8 +-
 src/backend/InvenTree/stock/serializers.py    |  21 ++
 src/backend/InvenTree/stock/test_api.py       | 180 ++++++++----------
 7 files changed, 208 insertions(+), 208 deletions(-)

diff --git a/src/backend/InvenTree/InvenTree/api_version.py b/src/backend/InvenTree/InvenTree/api_version.py
index 2de7bf0df3..4448546901 100644
--- a/src/backend/InvenTree/InvenTree/api_version.py
+++ b/src/backend/InvenTree/InvenTree/api_version.py
@@ -1,11 +1,15 @@
 """InvenTree API version information."""
 
 # InvenTree API version
-INVENTREE_API_VERSION = 490
+INVENTREE_API_VERSION = 491
 """Increment this API version number whenever there is a significant change to the API that any clients need to know about."""
 
 INVENTREE_API_TEXT = """
 
+v491 -> 2026-05-21 : https://github.com/inventree/InvenTree/pull/11979
+    - Add API serializer for deleting a part category
+    - Add API serializer for deleting a stock location
+
 v490 -> 2026-05-19 : https://github.com/inventree/InvenTree/pull/11963
     - moves user-self-filtered endpoints to /user/me/ to make their security boundaries clearer
 
diff --git a/src/backend/InvenTree/part/api.py b/src/backend/InvenTree/part/api.py
index 05fc1ca57a..0eac19e221 100644
--- a/src/backend/InvenTree/part/api.py
+++ b/src/backend/InvenTree/part/api.py
@@ -264,9 +264,12 @@ class CategoryDetail(CategoryMixin, OutputOptionsMixin, CustomRetrieveUpdateDest
 
     def destroy(self, request, *args, **kwargs):
         """Delete a Part category instance via the API."""
-        delete_parts = str2bool(request.data.get('delete_parts', False))
+        serializer = part_serializers.CategoryDeleteSerializer(data=request.data)
+        serializer.is_valid(raise_exception=True)
+
+        delete_parts = str2bool(serializer.validated_data.get('delete_parts', False))
         delete_child_categories = str2bool(
-            request.data.get('delete_child_categories', False)
+            serializer.validated_data.get('delete_child_categories', False)
         )
 
         return super().destroy(
diff --git a/src/backend/InvenTree/part/serializers.py b/src/backend/InvenTree/part/serializers.py
index dbb5605a43..f67f802a26 100644
--- a/src/backend/InvenTree/part/serializers.py
+++ b/src/backend/InvenTree/part/serializers.py
@@ -54,6 +54,27 @@ from .models import (
 logger = structlog.get_logger('inventree')
 
 
+class CategoryDeleteSerializer(serializers.Serializer):
+    """Serializer for deleting a PartCategory instance."""
+
+    class Meta:
+        """Metaclass options."""
+
+        fields = ['delete_child_categories', 'delete_parts']
+
+    delete_child_categories = serializers.BooleanField(
+        label=_('Delete Subcategories'),
+        help_text=_('Delete all sub-categories contained within this category'),
+        required=True,
+    )
+
+    delete_parts = serializers.BooleanField(
+        label=_('Delete Parts'),
+        help_text=_('Delete all parts contained within this category'),
+        required=True,
+    )
+
+
 @register_importer()
 class CategorySerializer(
     InvenTree.serializers.FilterableSerializerMixin,
diff --git a/src/backend/InvenTree/part/test_api.py b/src/backend/InvenTree/part/test_api.py
index aea80d5e7f..011c700884 100644
--- a/src/backend/InvenTree/part/test_api.py
+++ b/src/backend/InvenTree/part/test_api.py
@@ -3,7 +3,6 @@
 import os
 from datetime import datetime
 from decimal import Decimal
-from enum import IntEnum
 from random import randint
 
 from django.core.exceptions import ValidationError
@@ -331,116 +330,94 @@ class PartCategoryAPITest(InvenTreeAPITestCase):
 
     def test_category_delete(self):
         """Test category deletion with different parameters."""
-
-        class Target(IntEnum):
-            move_subcategories_to_parent_move_parts_to_parent = (0,)
-            move_subcategories_to_parent_delete_parts = (1,)
-            delete_subcategories_move_parts_to_parent = (2,)
-            delete_subcategories_delete_parts = (3,)
-
-        for i in range(4):
-            delete_child_categories: bool = False
-            delete_parts: bool = False
-
-            if i in (
-                Target.move_subcategories_to_parent_delete_parts,
-                Target.delete_subcategories_delete_parts,
-            ):
-                delete_parts = True
-            if i in (
-                Target.delete_subcategories_move_parts_to_parent,
-                Target.delete_subcategories_delete_parts,
-            ):
-                delete_child_categories = True
-
-            # Create a parent category
-            parent_category = PartCategory.objects.create(
-                name='Parent category',
-                description='This is the parent category where the child categories and parts are moved to',
-                parent=None,
-            )
-
-            category_count_before = PartCategory.objects.count()
-            part_count_before = Part.objects.count()
-
-            # Create a category to delete
-            cat_to_delete = PartCategory.objects.create(
-                name='Category to delete',
-                description='This is the category to be deleted',
-                parent=parent_category,
-            )
-
-            url = reverse('api-part-category-detail', kwargs={'pk': cat_to_delete.id})
-
-            parts = []
-            # Create parts in the category to be deleted
-            for jj in range(3):
-                parts.append(
-                    Part.objects.create(
-                        name=f'Part xyz {i}_{jj}',
-                        description='Child part of the deleted category',
-                        category=cat_to_delete,
-                    )
+        for delete_child_categories in [False, True]:
+            for delete_parts in [False, True]:
+                # Create a parent category
+                parent_category = PartCategory.objects.create(
+                    name='Parent category',
+                    description='This is the parent category where the child categories and parts are moved to',
+                    parent=None,
                 )
 
-            child_categories = []
-            child_categories_parts = []
-            # Create child categories under the category to be deleted
-            for ii in range(3):
-                child = PartCategory.objects.create(
-                    name=f'Child parent_cat {i}_{ii}',
-                    description='A child category of the deleted category',
-                    parent=cat_to_delete,
-                )
-                child_categories.append(child)
+                category_count_before = PartCategory.objects.count()
 
-                # Create parts in the child categories
+                # Create a category to delete
+                cat_to_delete = PartCategory.objects.create(
+                    name='Category to delete',
+                    description='This is the category to be deleted',
+                    parent=parent_category,
+                )
+
+                url = reverse(
+                    'api-part-category-detail', kwargs={'pk': cat_to_delete.id}
+                )
+
+                parts = []
+                # Create parts in the category to be deleted
                 for jj in range(3):
-                    child_categories_parts.append(
+                    parts.append(
                         Part.objects.create(
-                            name=f'Part xyz {i}_{jj}_{ii}',
-                            description='Child part in the child category of the deleted category',
-                            category=child,
+                            name=f'Part {"A" if delete_child_categories else "B"}{"C" if delete_parts else "D"}-{jj}',
+                            description='Child part of the deleted category',
+                            category=cat_to_delete,
                         )
                     )
 
-            # Delete the created category (sub categories and their parts will be moved under the parent)
-            params = {}
-            if delete_parts:
-                params['delete_parts'] = '1'
-            if delete_child_categories:
-                params['delete_child_categories'] = '1'
-            self.delete(url, params, expected_code=204)
-
-            if delete_parts:
-                if i == Target.delete_subcategories_delete_parts:
-                    # Check if all parts deleted
-                    self.assertEqual(Part.objects.count(), part_count_before)
-                elif i == Target.move_subcategories_to_parent_delete_parts:
-                    # Check if all parts deleted
-                    self.assertEqual(
-                        Part.objects.count(),
-                        part_count_before + len(child_categories_parts),
+                child_categories = []
+                child_categories_parts = []
+                # Create child categories under the category to be deleted
+                for ii in range(3):
+                    child = PartCategory.objects.create(
+                        name=f'Child parent_cat {ii}',
+                        description='A child category of the deleted category',
+                        parent=cat_to_delete,
                     )
-            else:
-                # parts moved to the parent category
-                for part in parts:
-                    part.refresh_from_db()
-                    self.assertEqual(part.category, parent_category)
+                    child_categories.append(child)
 
-                if delete_child_categories:
-                    for part in child_categories_parts:
+                    # Create parts in the child categories
+                    for jj in range(3):
+                        child_categories_parts.append(
+                            Part.objects.create(
+                                name=f'Part xyz {jj}_{ii}-{"E" if delete_child_categories else "F"}{"G" if delete_parts else "H"}',
+                                description='Child part in the child category of the deleted category',
+                                category=child,
+                            )
+                        )
+
+                # Delete the created category (sub categories and their parts will be moved under the parent)
+                params = {
+                    'delete_parts': delete_parts,
+                    'delete_child_categories': delete_child_categories,
+                }
+
+                self.delete(url, params, expected_code=204)
+
+                if delete_parts:
+                    # Check if all parts deleted
+                    for p in parts:
+                        with self.assertRaises(Part.DoesNotExist):
+                            p.refresh_from_db()
+                else:
+                    # parts moved to the parent category
+                    for part in parts:
                         part.refresh_from_db()
                         self.assertEqual(part.category, parent_category)
 
-            if delete_child_categories:
-                # Check if all categories are deleted
-                self.assertEqual(PartCategory.objects.count(), category_count_before)
-            else:
-                #  Check if all subcategories to parent moved to parent and all parts deleted
-                for child in child_categories:
-                    child.refresh_from_db()
-                    self.assertEqual(child.parent, parent_category)
+                    if delete_child_categories:
+                        for part in child_categories_parts:
+                            part.refresh_from_db()
+                            self.assertEqual(part.category, parent_category)
+
+                if delete_child_categories:
+                    # Check if all categories are deleted
+                    self.assertEqual(
+                        PartCategory.objects.count(), category_count_before
+                    )
+                else:
+                    #  Check if all subcategories to parent moved to parent and all parts deleted
+                    for child in child_categories:
+                        child.refresh_from_db()
+                        self.assertEqual(child.parent, parent_category)
 
     def test_structural(self):
         """Test the effectiveness of structural categories.
diff --git a/src/backend/InvenTree/stock/api.py b/src/backend/InvenTree/stock/api.py
index 1dd10a5c55..981bf6696d 100644
--- a/src/backend/InvenTree/stock/api.py
+++ b/src/backend/InvenTree/stock/api.py
@@ -430,11 +430,15 @@ class StockLocationDetail(
 
     def destroy(self, request, *args, **kwargs):
         """Delete a Stock location instance via the API."""
+        serializer = StockSerializers.LocationDeleteSerializer(data=request.data)
+        serializer.is_valid(raise_exception=True)
+
         delete_stock_items = InvenTree.helpers.str2bool(
-            request.data.get('delete_stock_items', False)
+            serializer.validated_data.get('delete_stock_items', False)
         )
+
         delete_sub_locations = InvenTree.helpers.str2bool(
-            request.data.get('delete_sub_locations', False)
+            serializer.validated_data.get('delete_sub_locations', False)
         )
 
         return super().destroy(
diff --git a/src/backend/InvenTree/stock/serializers.py b/src/backend/InvenTree/stock/serializers.py
index c1d6b5e94f..a87de263dc 100644
--- a/src/backend/InvenTree/stock/serializers.py
+++ b/src/backend/InvenTree/stock/serializers.py
@@ -1167,6 +1167,27 @@ class LocationTreeSerializer(InvenTree.serializers.InvenTreeModelSerializer):
         return queryset.annotate(sublocations=stock.filters.annotate_sub_locations())
 
 
+class LocationDeleteSerializer(serializers.Serializer):
+    """Serializer for deleting a stock location."""
+
+    class Meta:
+        """Metaclass options."""
+
+        fields = ['delete_stock_items', 'delete_sub_locations']
+
+    delete_stock_items = serializers.BooleanField(
+        required=True,
+        label=_('Delete Stock Items'),
+        help_text=_('Delete all stock items contained within this location'),
+    )
+
+    delete_sub_locations = serializers.BooleanField(
+        required=True,
+        label=_('Delete Sublocations'),
+        help_text=_('Delete all sub-locations contained within this location'),
+    )
+
+
 @register_importer()
 class LocationSerializer(
     InvenTree.serializers.FilterableSerializerMixin,
diff --git a/src/backend/InvenTree/stock/test_api.py b/src/backend/InvenTree/stock/test_api.py
index 060eef57f7..d274fffafa 100644
--- a/src/backend/InvenTree/stock/test_api.py
+++ b/src/backend/InvenTree/stock/test_api.py
@@ -3,7 +3,6 @@
 import os
 import random
 from datetime import datetime, timedelta
-from enum import IntEnum
 
 from django.contrib.contenttypes.models import ContentType
 from django.core.exceptions import ValidationError
@@ -142,13 +141,6 @@ class StockLocationTest(StockAPITestCase):
 
     def test_stock_location_delete(self):
         """Test stock location deletion with different parameters."""
-
-        class Target(IntEnum):
-            move_sub_locations_to_parent_move_stockitems_to_parent = (0,)
-            move_sub_locations_to_parent_delete_stockitems = (1,)
-            delete_sub_locations_move_stockitems_to_parent = (2,)
-            delete_sub_locations_delete_stockitems = (3,)
-
         # First, construct a set of template / variant parts
         part = Part.objects.create(
             name='Part for stock item creation',
@@ -157,117 +149,95 @@ class StockLocationTest(StockAPITestCase):
             is_template=False,
         )
 
-        for i in range(4):
-            delete_sub_locations: bool = False
-            delete_stock_items: bool = False
-
-            if i in (
-                Target.move_sub_locations_to_parent_delete_stockitems,
-                Target.delete_sub_locations_delete_stockitems,
-            ):
-                delete_stock_items = True
-            if i in (
-                Target.delete_sub_locations_move_stockitems_to_parent,
-                Target.delete_sub_locations_delete_stockitems,
-            ):
-                delete_sub_locations = True
-
-            # Create a parent stock location
-            parent_stock_location = StockLocation.objects.create(
-                name='Parent stock location',
-                description='This is the parent stock location where the sub categories and stock items are moved to',
-                parent=None,
-            )
-
-            stocklocation_count_before = StockLocation.objects.count()
-            stock_location_count_before = StockItem.objects.count()
-
-            # Create a stock location to be deleted
-            stock_location_to_delete = StockLocation.objects.create(
-                name='Stock location to delete',
-                description='This is the stock location to be deleted',
-                parent=parent_stock_location,
-            )
-
-            url = reverse(
-                'api-location-detail', kwargs={'pk': stock_location_to_delete.id}
-            )
-
-            stock_items = []
-            # Create stock items in the location to be deleted
-            for jj in range(3):
-                stock_items.append(
-                    StockItem.objects.create(
-                        batch=f'Batch xyz {jj}',
-                        location=stock_location_to_delete,
-                        part=part,
-                    )
+        for delete_sub_locations in [False, True]:
+            for delete_stock_items in [False, True]:
+                # Create a parent stock location
+                parent_stock_location = StockLocation.objects.create(
+                    name='Parent stock location',
+                    description='This is the parent stock location where the sub categories and stock items are moved to',
+                    parent=None,
                 )
 
-            child_stock_locations = []
-            child_stock_locations_items = []
-            # Create sub location under the stock location to be deleted
-            for ii in range(3):
-                child = StockLocation.objects.create(
-                    name=f'Sub-location {ii}',
-                    description='A sub-location of the deleted stock location',
-                    parent=stock_location_to_delete,
-                )
-                child_stock_locations.append(child)
+                location_count_before = StockLocation.objects.count()
+                item_count_before = StockItem.objects.count()
 
-                # Create stock items in the sub locations
+                # Create a stock location to be deleted
+                location_to_delete = StockLocation.objects.create(
+                    name='Stock location to delete',
+                    description='This is the stock location to be deleted',
+                    parent=parent_stock_location,
+                )
+
+                url = reverse(
+                    'api-location-detail', kwargs={'pk': location_to_delete.id}
+                )
+
+                stock_items = []
+
+                # Create stock items in the location to be deleted
                 for jj in range(3):
-                    child_stock_locations_items.append(
+                    stock_items.append(
                         StockItem.objects.create(
-                            batch=f'B xyz {jj}', part=part, location=child
+                            batch=f'Batch xyz {jj}',
+                            location=location_to_delete,
+                            part=part,
                         )
                     )
 
-            # Delete the created stock location
-            params = {}
-            if delete_stock_items:
-                params['delete_stock_items'] = '1'
-            if delete_sub_locations:
-                params['delete_sub_locations'] = '1'
-            response = self.delete(url, params, expected_code=204)
+                child_locations = []
+                child_locations_items = []
 
-            self.assertEqual(response.status_code, 204)
+                # Create sub location under the stock location to be deleted
+                for ii in range(3):
+                    child = StockLocation.objects.create(
+                        name=f'Sub-location {ii}',
+                        description='A sub-location of the deleted stock location',
+                        parent=location_to_delete,
+                    )
+                    child_locations.append(child)
 
-            if delete_stock_items:
-                if i == Target.delete_sub_locations_delete_stockitems:
-                    # Check if all sub-categories deleted
+                    # Create stock items in the sub locations
+                    for jj in range(3):
+                        child_locations_items.append(
+                            StockItem.objects.create(
+                                batch=f'B xyz {jj}', part=part, location=child
+                            )
+                        )
+
+                # Delete the created stock location
+                params = {
+                    'delete_stock_items': delete_stock_items,
+                    'delete_sub_locations': delete_sub_locations,
+                }
+
+                response = self.delete(url, data=params, expected_code=204)
+
+                self.assertEqual(response.status_code, 204)
+
+                # If we were deleting stock items, the count must not have changed
+                if delete_stock_items:
+                    extra_items = 0 if delete_sub_locations else 9
                     self.assertEqual(
-                        StockItem.objects.count(), stock_location_count_before
+                        StockItem.objects.count(), item_count_before + extra_items
                     )
-                elif i == Target.move_sub_locations_to_parent_delete_stockitems:
-                    # Check if all stock locations deleted
-                    self.assertEqual(
-                        StockItem.objects.count(),
-                        stock_location_count_before + len(child_stock_locations_items),
-                    )
-            else:
-                # Stock locations moved to the parent location
-                for stock_item in stock_items:
-                    stock_item.refresh_from_db()
-                    self.assertEqual(stock_item.location, parent_stock_location)
+                else:
+                    # Stock items moved to the parent location
+                    self.assertGreater(StockItem.objects.count(), item_count_before)
+
+                    for stock_item in stock_items:
+                        stock_item.refresh_from_db()
+                        self.assertEqual(stock_item.location, parent_stock_location)
 
                 if delete_sub_locations:
-                    for child_stock_location_item in child_stock_locations_items:
-                        child_stock_location_item.refresh_from_db()
-                        self.assertEqual(
-                            child_stock_location_item.location, parent_stock_location
-                        )
-
-            if delete_sub_locations:
-                # Check if all sub-locations are deleted
-                self.assertEqual(
-                    StockLocation.objects.count(), stocklocation_count_before
-                )
-            else:
-                #  Check if all sub-locations moved to the parent
-                for child in child_stock_locations:
-                    child.refresh_from_db()
-                    self.assertEqual(child.parent, parent_stock_location)
+                    # Check if all sub-categories deleted
+                    self.assertEqual(
+                        StockLocation.objects.count(), location_count_before
+                    )
+                else:
+                    # Check if all sub-categories moved to the parent category
+                    for location in child_locations:
+                        location.refresh_from_db()
+                        self.assertEqual(location.parent, parent_stock_location)
 
     def test_output_options(self):
         """Test output options."""

From 5718b49bf12e7ac31474a297764c2976ca558427 Mon Sep 17 00:00:00 2001
From: Oliver <oliver.henry.walters@gmail.com>
Date: Fri, 22 May 2026 14:37:48 +1000
Subject: [PATCH 07/10] Fix text size in build line table (#11986)

---
 src/frontend/src/tables/build/BuildLineTable.tsx | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/src/frontend/src/tables/build/BuildLineTable.tsx b/src/frontend/src/tables/build/BuildLineTable.tsx
index 2e0a07a18a..07fbe7d6f4 100644
--- a/src/frontend/src/tables/build/BuildLineTable.tsx
+++ b/src/frontend/src/tables/build/BuildLineTable.tsx
@@ -536,7 +536,10 @@ export default function BuildLineTable({
         minWidth: 125,
         render: (record: any) => {
           return record?.bom_item_detail?.consumable ? (
-            <Text style={{ fontStyle: 'italic' }}>{t`Consumable item`}</Text>
+            <Text
+              size='sm'
+              style={{ fontStyle: 'italic' }}
+            >{t`Consumable item`}</Text>
           ) : (
             <ProgressBar
               progressLabel={true}

From 54896560162b671ff10719c4550c7778a0dab764 Mon Sep 17 00:00:00 2001
From: Oliver <oliver.henry.walters@gmail.com>
Date: Fri, 22 May 2026 15:19:01 +1000
Subject: [PATCH 08/10] [UI] Fix settings rendering (#11987)

- Do not duplicate global plugin settings
---
 .../Index/Settings/PluginSettingsGroup.tsx    | 24 +++++++++++--------
 .../pages/Index/Settings/SystemSettings.tsx   | 12 ++++------
 .../src/pages/Index/Settings/UserSettings.tsx | 12 ++++------
 3 files changed, 24 insertions(+), 24 deletions(-)

diff --git a/src/frontend/src/pages/Index/Settings/PluginSettingsGroup.tsx b/src/frontend/src/pages/Index/Settings/PluginSettingsGroup.tsx
index 79f470498f..5b07a0601b 100644
--- a/src/frontend/src/pages/Index/Settings/PluginSettingsGroup.tsx
+++ b/src/frontend/src/pages/Index/Settings/PluginSettingsGroup.tsx
@@ -70,10 +70,12 @@ function PluginSettingGroupItem({
 export default function PluginSettingsGroup({
   mixin,
   message,
+  includeBaseSettings,
   global
 }: {
   global: boolean;
   message?: string;
+  includeBaseSettings?: boolean;
   mixin?: string;
 }) {
   const mixins: string = useMemo(() => {
@@ -99,16 +101,18 @@ export default function PluginSettingsGroup({
 
   return (
     <Stack gap='xs'>
-      <Accordion defaultValue='plugin-settings'>
-        <Accordion.Item value='plugin-settings'>
-          <Accordion.Control>
-            <StylishText size='lg'>{t`Plugin Settings`}</StylishText>
-          </Accordion.Control>
-          <Accordion.Panel>
-            <GlobalSettingList keys={PLUGIN_SETTINGS_KEYS} />
-          </Accordion.Panel>
-        </Accordion.Item>
-      </Accordion>
+      {includeBaseSettings == true && (
+        <Accordion defaultValue='plugin-settings'>
+          <Accordion.Item value='plugin-settings'>
+            <Accordion.Control>
+              <StylishText size='lg'>{t`Plugin Settings`}</StylishText>
+            </Accordion.Control>
+            <Accordion.Panel>
+              <GlobalSettingList keys={PLUGIN_SETTINGS_KEYS} />
+            </Accordion.Panel>
+          </Accordion.Item>
+        </Accordion>
+      )}
       <Alert color='blue' icon={<IconInfoCircle />}>
         <Text>
           {message ??
diff --git a/src/frontend/src/pages/Index/Settings/SystemSettings.tsx b/src/frontend/src/pages/Index/Settings/SystemSettings.tsx
index a79d501087..bd5c368b8f 100644
--- a/src/frontend/src/pages/Index/Settings/SystemSettings.tsx
+++ b/src/frontend/src/pages/Index/Settings/SystemSettings.tsx
@@ -15,7 +15,7 @@ import {
   IconShoppingCart,
   IconTruckDelivery
 } from '@tabler/icons-react';
-import { lazy, useMemo } from 'react';
+import { useMemo } from 'react';
 
 import { PluginPanelKey } from '@lib/enums/ModelType';
 import type { PanelType } from '@lib/types/Panel';
@@ -25,13 +25,9 @@ import PageTitle from '../../../components/nav/PageTitle';
 import { SettingsHeader } from '../../../components/nav/SettingsHeader';
 import { PanelGroup } from '../../../components/panels/PanelGroup';
 import { GlobalSettingList } from '../../../components/settings/SettingList';
-import { Loadable } from '../../../functions/loading';
 import { useServerApiState } from '../../../states/ServerApiState';
 import { useUserState } from '../../../states/UserState';
-
-const PluginSettingsGroup = Loadable(
-  lazy(() => import('./PluginSettingsGroup'))
-);
+import PluginSettingsGroup from './PluginSettingsGroup';
 
 /**
  * System settings page
@@ -371,7 +367,9 @@ export default function SystemSettings() {
         name: 'plugins',
         label: t`Plugins`,
         icon: <IconPlugConnected />,
-        content: <PluginSettingsGroup global={true} />
+        content: (
+          <PluginSettingsGroup global={true} includeBaseSettings={true} />
+        )
       }
     ];
   }, []);
diff --git a/src/frontend/src/pages/Index/Settings/UserSettings.tsx b/src/frontend/src/pages/Index/Settings/UserSettings.tsx
index 5d6b435fd1..88dfbcfdb0 100644
--- a/src/frontend/src/pages/Index/Settings/UserSettings.tsx
+++ b/src/frontend/src/pages/Index/Settings/UserSettings.tsx
@@ -9,7 +9,7 @@ import {
   IconSearch,
   IconUserCircle
 } from '@tabler/icons-react';
-import { lazy, useMemo } from 'react';
+import { useMemo } from 'react';
 
 import { PluginPanelKey } from '@lib/enums/ModelType';
 import type { PanelType } from '@lib/types/Panel';
@@ -18,14 +18,10 @@ import PageTitle from '../../../components/nav/PageTitle';
 import { SettingsHeader } from '../../../components/nav/SettingsHeader';
 import { PanelGroup } from '../../../components/panels/PanelGroup';
 import { UserSettingList } from '../../../components/settings/SettingList';
-import { Loadable } from '../../../functions/loading';
 import { useUserState } from '../../../states/UserState';
 import { SecurityContent } from './AccountSettings/SecurityContent';
 import { AccountContent } from './AccountSettings/UserPanel';
-
-const PluginSettingsGroup = Loadable(
-  lazy(() => import('./PluginSettingsGroup'))
-);
+import PluginSettingsGroup from './PluginSettingsGroup';
 
 /**
  * User settings page
@@ -130,7 +126,9 @@ export default function UserSettings() {
         name: 'plugins',
         label: t`Plugin Settings`,
         icon: <IconPlugConnected />,
-        content: <PluginSettingsGroup global={false} />
+        content: (
+          <PluginSettingsGroup global={false} includeBaseSettings={true} />
+        )
       }
     ];
   }, []);

From 74d9ab6d11393489987a3ca84ed29b422881acc2 Mon Sep 17 00:00:00 2001
From: Jacob Felknor <jacobfelknor073@gmail.com>
Date: Fri, 22 May 2026 01:08:40 -0600
Subject: [PATCH 09/10] Transfer Order (#11281)

* initial skel commit for transfer orders

* initial transfer order backend model

* add some serializers, rename PLACED to ISSUED for TransferOrders

* adding from admin console works

* simple table list almost working, but we need to add order line items....

* add other cols to table

* add Transfer Order from table view

* moving towards a detail view

* wip: adding detail view

* add take from and destination serializer details

* add other detail grid items

* edit/duplicate transfer order

* more action buttons

* first crack at adding line items

* add to line item

* add filters

* starting work on row actions

* more action buttons for line items

* fix copy lines in duplicate

* basic allocation works

* allocations table actions

* allocate serials

* allocated serial row expansion

* add transferred qty to serializers

* move items on complete, show in tracking

* change panel to transferred stock upon complete

* allow incomplete line items

* disable edit allocations when completed

* add ref pattern and to settings

* add admin to line item inline

* add calendar and parametric view

* basic transfer order report

* add transfer order ruleset

* starting allocation buisness logic throughout for TOs

* disable accept incomplete logic, which was incorrect, until I fix

* fix incomplete allocation option

* add transferred col to default report

* add transfer order to calendar ics view

* chain condition for readability

* add transfer order allocations table to stockitem view

* don't account TO allocations in availability

* add transfer orders table for a part

* 'consume' option by doing take_stock

* squash migrations

* starting to test transfer order

* more transfer order tests

* add transfer order consume test

* wip, more tests

* more transfer order tests

* had to refresh_from_db

* switch "to" to "transfer-order" in url paths

* only select non-virtual parts from transfer order

* add transfer order docs

* deconflict migrations

* fix frontend build error

* fix validation on transfer order reference pattern

* add oath2 scope for transfer order

* fix state test to include transfer order state

* add barcode_model_type_code for transfer order

* bump api version

* check view role for transfer order, remove debug/commented out lines

* add serialized allocation test

* Fix migrations

* Frontend fixes

* Implement required 'company' attribute

* transfer order report context

* attempt to fix tests

* delete transfer order allocations on cancel

* add a few playwright tests, more incoming

* more playwright

* add source and destination locations to table

* deconflict migrations

* Fix build issue

* attempt to fix flaky transfer order test

* duplicate transfer order before running tests

* Adjust playwright tests

* Fix migration dependency order

---------

Co-authored-by: Oliver <oliver.henry.walters@gmail.com>
Co-authored-by: Matthias Mair <code@mjmair.com>
---
 docs/docs/api/schema.md                       |   2 +-
 .../images/stock/transfer_order_calendar.png  | Bin 0 -> 44399 bytes
 .../images/stock/transfer_order_display.png   | Bin 0 -> 89501 bytes
 .../images/stock/transfer_order_list.png      | Bin 0 -> 56809 bytes
 docs/docs/concepts/custom_states.md           |   1 +
 docs/docs/settings/global.md                  |   4 +
 docs/docs/stock/transfer_order.md             | 150 ++++
 docs/mkdocs.yml                               |   1 +
 .../InvenTree/InvenTree/api_version.py        |   5 +-
 .../InvenTree/common/setting/system.py        |  20 +
 src/backend/InvenTree/generic/states/tests.py |   6 +-
 src/backend/InvenTree/order/admin.py          |  38 +
 src/backend/InvenTree/order/api.py            | 625 ++++++++++++-
 src/backend/InvenTree/order/events.py         |   9 +
 .../order/fixtures/transfer_order.yaml        |  68 ++
 .../order/migrations/0118_transferorder.py    | 482 ++++++++++
 .../0119_transferorderlineitem_line_int.py    |  18 +
 src/backend/InvenTree/order/models.py         | 695 +++++++++++++-
 src/backend/InvenTree/order/serializers.py    | 620 +++++++++++++
 src/backend/InvenTree/order/status_codes.py   |  27 +
 src/backend/InvenTree/order/test_api.py       | 850 +++++++++++++++++-
 src/backend/InvenTree/order/validators.py     |  21 +
 src/backend/InvenTree/part/filters.py         |  40 +-
 src/backend/InvenTree/part/models.py          |  47 +-
 src/backend/InvenTree/part/serializers.py     |   7 +
 src/backend/InvenTree/report/apps.py          |   7 +
 .../inventree_transfer_order_report.html      |  52 ++
 src/backend/InvenTree/stock/api.py            |  16 +-
 src/backend/InvenTree/stock/models.py         |  53 +-
 src/backend/InvenTree/stock/serializers.py    |   6 +
 src/backend/InvenTree/users/oauth2_scopes.py  |   1 +
 src/backend/InvenTree/users/ruleset.py        |   7 +
 src/frontend/lib/enums/ApiEndpoints.tsx       |  11 +
 src/frontend/lib/enums/ModelInformation.tsx   |  16 +
 src/frontend/lib/enums/ModelType.tsx          |   2 +
 src/frontend/lib/enums/Roles.tsx              |   3 +
 .../src/components/render/Instance.tsx        |   6 +-
 src/frontend/src/components/render/Order.tsx  |  43 +
 src/frontend/src/defaults/backendMappings.tsx |   2 +
 src/frontend/src/forms/TransferOrderForms.tsx | 308 +++++++
 src/frontend/src/functions/icons.tsx          |   3 +
 .../pages/Index/Settings/SystemSettings.tsx   |  15 +
 src/frontend/src/pages/part/PartDetail.tsx    |  16 +
 .../src/pages/stock/LocationDetail.tsx        |  48 +-
 src/frontend/src/pages/stock/StockDetail.tsx  |  36 +-
 .../src/pages/stock/TransferOrderDetail.tsx   | 552 ++++++++++++
 src/frontend/src/router.tsx                   |   5 +
 .../src/tables/stock/StockTrackingTable.tsx   |  14 +-
 .../stock/TransferOrderAllocationTable.tsx    | 285 ++++++
 .../stock/TransferOrderLineItemTable.tsx      | 529 +++++++++++
 .../stock/TransferOrderParametricTable.tsx    |  48 +
 .../src/tables/stock/TransferOrderTable.tsx   | 185 ++++
 src/frontend/tests/pages/pui_stock.spec.ts    | 208 +++++
 53 files changed, 6178 insertions(+), 35 deletions(-)
 create mode 100644 docs/docs/assets/images/stock/transfer_order_calendar.png
 create mode 100644 docs/docs/assets/images/stock/transfer_order_display.png
 create mode 100644 docs/docs/assets/images/stock/transfer_order_list.png
 create mode 100644 docs/docs/stock/transfer_order.md
 create mode 100644 src/backend/InvenTree/order/fixtures/transfer_order.yaml
 create mode 100644 src/backend/InvenTree/order/migrations/0118_transferorder.py
 create mode 100644 src/backend/InvenTree/order/migrations/0119_transferorderlineitem_line_int.py
 create mode 100644 src/backend/InvenTree/report/templates/report/inventree_transfer_order_report.html
 create mode 100644 src/frontend/src/forms/TransferOrderForms.tsx
 create mode 100644 src/frontend/src/pages/stock/TransferOrderDetail.tsx
 create mode 100644 src/frontend/src/tables/stock/TransferOrderAllocationTable.tsx
 create mode 100644 src/frontend/src/tables/stock/TransferOrderLineItemTable.tsx
 create mode 100644 src/frontend/src/tables/stock/TransferOrderParametricTable.tsx
 create mode 100644 src/frontend/src/tables/stock/TransferOrderTable.tsx

diff --git a/docs/docs/api/schema.md b/docs/docs/api/schema.md
index ba610a0773..49c88f3a46 100644
--- a/docs/docs/api/schema.md
+++ b/docs/docs/api/schema.md
@@ -7,7 +7,7 @@ The API schema as documented below is generated using the [drf-spectactular](htt
 
 ## API Version
 
-This documentation is for API version: `449`
+This documentation is for API version: `459`
 
 !!! tip "API Schema History"
     We track API schema changes, and provide a snapshot of each API schema version in the [API schema repository](https://github.com/inventree/schema/).
diff --git a/docs/docs/assets/images/stock/transfer_order_calendar.png b/docs/docs/assets/images/stock/transfer_order_calendar.png
new file mode 100644
index 0000000000000000000000000000000000000000..b04ccb30a58f437b71335b934842ff9a542b5300
GIT binary patch
literal 44399
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
NPs>=dTK&bFe*+qDU-tk2

literal 0
HcmV?d00001

diff --git a/docs/docs/assets/images/stock/transfer_order_display.png b/docs/docs/assets/images/stock/transfer_order_display.png
new file mode 100644
index 0000000000000000000000000000000000000000..c1e0bcb335f1de15ed50797d6d212a6855f7d4e3
GIT binary patch
literal 89501
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
Ydg=YFl$Ue*0zisAUHx3vIVCg!06tTm!2kdN

literal 0
HcmV?d00001

diff --git a/docs/docs/assets/images/stock/transfer_order_list.png b/docs/docs/assets/images/stock/transfer_order_list.png
new file mode 100644
index 0000000000000000000000000000000000000000..b371ac350a5b62bdd8b86ed74a1dd21d4b382e04
GIT binary patch
literal 56809
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
WOfP`brO%-3)3<NkF{v=}{Po{-vur~E

literal 0
HcmV?d00001

diff --git a/docs/docs/concepts/custom_states.md b/docs/docs/concepts/custom_states.md
index aab4e37ea0..1244939507 100644
--- a/docs/docs/concepts/custom_states.md
+++ b/docs/docs/concepts/custom_states.md
@@ -17,3 +17,4 @@ Custom states can be defined for the following models:
 - [Purchase Order](../purchasing/purchase_order.md)
 - [Sales Order](../sales/sales_order.md)
 - [Return Order](../sales/return_order.md)
+- [Transfer Order](../stock/transfer_order.md)
diff --git a/docs/docs/settings/global.md b/docs/docs/settings/global.md
index f42f19a906..d5f33061cb 100644
--- a/docs/docs/settings/global.md
+++ b/docs/docs/settings/global.md
@@ -240,6 +240,10 @@ Refer to the [sales order settings](../sales/sales_order.md#sales-order-settings
 
 Refer to the [return order settings](../sales/return_order.md#return-order-settings).
 
+### Transfer Orders
+
+Refer to the [transfer order settings](../stock/transfer_order.md#transfer-order-settings).
+
 ### Plugin Settings
 
 | Name | Description | Default | Units |
diff --git a/docs/docs/stock/transfer_order.md b/docs/docs/stock/transfer_order.md
new file mode 100644
index 0000000000..12381255e5
--- /dev/null
+++ b/docs/docs/stock/transfer_order.md
@@ -0,0 +1,150 @@
+
+---
+title: Transfer Orders
+---
+
+## Transfer Orders
+
+Transfer orders provide a method for requesting stock to be moved from one location to another. It does not replace the existing on-demand stock transaction options, but lets you "document" many transactions from a single view.
+
+### View Transfer Orders
+
+To navigate to the Transfer Order display, select *Stock* from the main navigation menu, and *Transfer Orders* from the sidebar:
+
+{{ image("stock/transfer_order_display.png", "Transfer Order display") }}
+
+The following view modes are available:
+
+#### Table View
+
+*Table View* provides a list of Transfer Orders, which can be filtered to display a subset of orders according to user supplied parameters.
+
+{{ image("stock/transfer_order_list.png", "Transfer Order list") }}
+
+#### Calendar View
+
+*Calendar View* shows a calendar display with outstanding transfer orders.
+
+{{ image("stock/transfer_order_calendar.png", "Transfer Order calendar") }}
+
+### Transfer Order Status Codes
+
+Each Transfer Order has a specific status code, which represents the state of the order:
+
+| Status | Description |
+| --- | --- |
+| Pending | The transfer order has been created, but has not been finalized or submitted |
+| Issued | The transfer order has been issued, and is in progress |
+| On Hold | The transfer order has been placed on hold, but is still active |
+| Complete | The transfer order is fully completed, and is now closed |
+| Cancelled | The transfer order was cancelled, and is now closed |
+
+**Source Code**
+
+Refer to the source code for the Transfer Order status codes:
+
+::: order.status_codes.TransferOrderStatus
+    options:
+        show_bases: False
+        show_root_heading: False
+        show_root_toc_entry: False
+        show_source: True
+        members: []
+
+Transfer Order Status supports [custom states](../concepts/custom_states.md).
+
+### Transfer Order Parameters
+
+The following parameters are available for each Transfer Order, and can be edited by the user:
+
+| Parameter | Description |
+| --- | --- |
+| Reference | Transfer Order reference e.g. '001' |
+| Description | Description of the Transfer Order |
+| Project Code | Project Code of the Transfer Order |
+| Source Location | Stock location to source stock items from (blank = all locations) |
+| Destination Location | Stock location where the stock will be transferred |
+| Consume Stock | Rather than transfer the stock to the destination, "consume" it by removing the specified quantity from the allocated stock item
+| Start Date | The scheduled start date for the transfer |
+| Target Date | Target date for transfer completion |
+| External Link | Link to external webpage |
+| Responsible | User (or group of users) who is responsible for the transfer |
+| Notes | Transfer notes, supports markdown |
+
+## Create a Transfer Order
+
+Once the transfer order page is loaded, click on <span class="badge inventree add">{{ icon("plus-circle") }} New Transfer Order</span> which opens the "Create Transfer Order" form.
+
+Fill out the rest of the form with the transfer order information then click on <span class="badge inventree confirm">Submit</span> to create the order.
+
+### Transfer Order Reference
+
+Each Transfer Order is uniquely identified by its *Reference* field. Read more about [reference fields](../settings/reference.md).
+
+### Add Line Items
+
+On the transfer order detail page, user can link parts to the transfer order selecting the <span class="badge inventree nav side">{{ icon("list") }}</span> Line Items</span> tab then clicking on the <span class="badge inventree add">{{ icon("plus-circle") }} Add Line Item</span> button.
+
+Once the "Add Line Item" form opens, select a part in the list.
+
+!!! warning
+    Only parts that have the "Virtual" attribute disabled will be shown and can be selected.
+
+Fill out the rest of the form then click on <span class="badge inventree confirm">Submit</span>
+
+### Allocate Stock Items
+
+After line items were created, user can either:
+
+* Allocate stock items for that part to the transfer order (click on {{ icon("arrow-right") }} button)
+* Create a build order for that part to cover the quantity of the transfer order (click on {{ icon("tools") }} button)
+
+### Complete Order
+
+Once all items in the transfer order have been allocated, click on <span class="badge inventree add">{{ icon("circle-check", color="green") }} Complete Order</span> to mark the transfer order as complete. Confirm then click on <span class="badge inventree confirm">Submit</span> to complete the order.
+
+### Transferred Stock
+
+After completing the transfer order, a <span class="badge inventree nav side">{{ icon("list") }}</span> Transferred Stock</span> tab will appear showing which stock was affected.
+
+!!! warning
+    Similar to received stock on purchase orders, this tab will only be accurate while the affected stock items still exist. Furthermore, if the stock item is depleted while using the "consume" parameter, it will not appear here unless "delete on deplete" is turned off for this stock item
+
+### Cancel Order
+
+To cancel the order, click on the {{ icon("tools") }} menu button next to the <span class="badge inventree add">{{ icon("circle-check", color="green") }} Complete Order</span> button, then click on the "{{ icon("tools") }} Cancel Order" menu option. Confirm then click on the <span class="badge inventree confirm">Submit</span> to cancel the order.
+
+## Order Scheduling
+
+Transfer orders can be scheduled for a future date, to allow for order scheduling.
+
+### Start Date
+
+The *Start Date* of the transfer order is the date on which the order is scheduled to be issued, allowing work to begin on the order.
+
+### Target Date
+
+The *Target Date* of the transfer order is the date on which the order is scheduled to be completed.
+
+### Overdue Orders
+
+If the *Target Date* of the transfer order has passed, the order will be marked as *overdue*.
+
+## Calendar view
+
+Using the button to the top right of the list of Transfer Orders, the view can be switched to a calendar view using the button {{ icon("calendar") }}. This view shows orders with a defined target date only.
+
+This view can be accessed externally as an ICS calendar using a URL like the following:
+`http://inventree.example.org/api/order/calendar/transfer-order/calendar.ics`
+
+By default, completed orders are not exported. These can be included by appending `?include_completed=True` to the URL.
+
+## Transfer Order Settings
+
+The following [global settings](../settings/global.md) are available for transfer orders:
+
+| Name | Description | Default | Units |
+| ---- | ----------- | ------- | ----- |
+{{ globalsetting("TRANSFERORDER_ENABLED") }}
+{{ globalsetting("TRANSFERORDER_REFERENCE_PATTERN") }}
+{{ globalsetting("TRANSFERORDER_REQUIRE_RESPONSIBLE") }}
diff --git a/docs/mkdocs.yml b/docs/mkdocs.yml
index 82bb9cd772..e477632584 100644
--- a/docs/mkdocs.yml
+++ b/docs/mkdocs.yml
@@ -145,6 +145,7 @@ nav:
     - Stock Expiry: stock/expiry.md
     - Stock Ownership: stock/owner.md
     - Test Results: stock/test.md
+    - Transfer Orders: stock/transfer_order.md
   - Manufacturing:
     - Manufacturing: manufacturing/index.md
     - Bill of Materials: manufacturing/bom.md
diff --git a/src/backend/InvenTree/InvenTree/api_version.py b/src/backend/InvenTree/InvenTree/api_version.py
index 4448546901..64b1ffdf46 100644
--- a/src/backend/InvenTree/InvenTree/api_version.py
+++ b/src/backend/InvenTree/InvenTree/api_version.py
@@ -1,11 +1,14 @@
 """InvenTree API version information."""
 
 # InvenTree API version
-INVENTREE_API_VERSION = 491
+INVENTREE_API_VERSION = 492
 """Increment this API version number whenever there is a significant change to the API that any clients need to know about."""
 
 INVENTREE_API_TEXT = """
 
+v492 -> 2026-05-22 : https://github.com/inventree/InvenTree/pull/11281
+    - Add Transfer Order model and associated API endpoint
+
 v491 -> 2026-05-21 : https://github.com/inventree/InvenTree/pull/11979
     - Add API serializer for deleting a part category
     - Add API serializer for deleting a stock location
diff --git a/src/backend/InvenTree/common/setting/system.py b/src/backend/InvenTree/common/setting/system.py
index 394745db82..456d7de095 100644
--- a/src/backend/InvenTree/common/setting/system.py
+++ b/src/backend/InvenTree/common/setting/system.py
@@ -904,6 +904,26 @@ SYSTEM_SETTINGS: dict[str, InvenTreeSettingsKeyType] = {
         'default': False,
         'validator': bool,
     },
+    'TRANSFERORDER_ENABLED': {
+        'name': _('Enable Transfer Orders'),
+        'description': _('Enable transfer order functionality in the user interface'),
+        'validator': bool,
+        'default': False,
+    },
+    'TRANSFERORDER_REFERENCE_PATTERN': {
+        'name': _('Transfer Order Reference Pattern'),
+        'description': _(
+            'Required pattern for generating Transfer Order reference field'
+        ),
+        'default': 'TO-{ref:04d}',
+        'validator': order.validators.validate_transfer_order_reference_pattern,
+    },
+    'TRANSFERORDER_REQUIRE_RESPONSIBLE': {
+        'name': _('Require Responsible Owner'),
+        'description': _('A responsible owner must be assigned to each order'),
+        'default': False,
+        'validator': bool,
+    },
     'SALESORDER_BLOCK_INCOMPLETE_ITEM_TESTS': {
         'name': _('Block Incomplete Item Tests'),
         'description': _(
diff --git a/src/backend/InvenTree/generic/states/tests.py b/src/backend/InvenTree/generic/states/tests.py
index 17a2221d1f..fe33eaf78e 100644
--- a/src/backend/InvenTree/generic/states/tests.py
+++ b/src/backend/InvenTree/generic/states/tests.py
@@ -232,8 +232,8 @@ class ApiTests(InvenTreeAPITestCase):
         """Test the API endpoint for listing all status models."""
         response = self.get(reverse('api-status-all'))
 
-        # 10 built-in state classes, plus the added GeneralState class
-        self.assertEqual(len(response.data), 11)
+        # 11 built-in state classes, plus the added GeneralState class
+        self.assertEqual(len(response.data), 12)
 
         # Test the BuildStatus model
         build_status = response.data['BuildStatus']
@@ -273,7 +273,7 @@ class ApiTests(InvenTreeAPITestCase):
         )
         response = self.get(reverse('api-status-all'))
 
-        self.assertEqual(len(response.data), 11)
+        self.assertEqual(len(response.data), 12)
 
         stock_status_cstm = response.data['StockStatus']
         self.assertEqual(stock_status_cstm['status_class'], 'StockStatus')
diff --git a/src/backend/InvenTree/order/admin.py b/src/backend/InvenTree/order/admin.py
index 70b7b3c13b..875ebdb763 100644
--- a/src/backend/InvenTree/order/admin.py
+++ b/src/backend/InvenTree/order/admin.py
@@ -170,3 +170,41 @@ class ReturnOrderLineItemAdmin(admin.ModelAdmin):
 @admin.register(models.ReturnOrderExtraLine)
 class ReturnOrdeerExtraLineAdmin(GeneralExtraLineAdmin, admin.ModelAdmin):
     """Admin class for the ReturnOrderExtraLine model."""
+
+
+class TransferOrderLineItemInlineAdmin(admin.StackedInline):
+    """Inline admin class for the TransferOrderLineItem model."""
+
+    autocomplete_fields = ['part']
+
+    model = models.TransferOrderLineItem
+    extra = 0
+
+
+@admin.register(models.TransferOrder)
+class TransferOrderAdmin(admin.ModelAdmin):
+    """Admin class for the TransferOrder model."""
+
+    exclude = ['reference_int', 'address', 'contact']
+
+    list_display = (
+        'reference',
+        'status',
+        'description',
+        'take_from',
+        'destination',
+        'consume',
+        'creation_date',
+    )
+
+    search_fields = ['reference', 'description']
+
+    inlines = [TransferOrderLineItemInlineAdmin]
+
+    autocomplete_fields = [
+        'created_by',
+        'take_from',
+        'destination',
+        'project_code',
+        'responsible',
+    ]
diff --git a/src/backend/InvenTree/order/api.py b/src/backend/InvenTree/order/api.py
index 9c608e32a5..709cf3ba26 100644
--- a/src/backend/InvenTree/order/api.py
+++ b/src/backend/InvenTree/order/api.py
@@ -56,6 +56,8 @@ from order.status_codes import (
     ReturnOrderStatus,
     SalesOrderStatus,
     SalesOrderStatusGroups,
+    TransferOrderStatus,
+    TransferOrderStatusGroups,
 )
 from part.models import Part
 from users.models import Owner
@@ -1766,6 +1768,521 @@ class ReturnOrderExtraLineDetail(RetrieveUpdateDestroyAPI):
     serializer_class = serializers.ReturnOrderExtraLineSerializer
 
 
+class TransferOrderFilter(OrderFilter):
+    """Custom API filters for the TransferOrderList endpoint."""
+
+    class Meta:
+        """Metaclass options."""
+
+        model = models.TransferOrder
+        fields = []
+
+    include_variants = rest_filters.BooleanFilter(
+        label=_('Include Variants'), method='filter_include_variants'
+    )
+
+    def filter_include_variants(self, queryset, name, value):
+        """Filter by whether or not to include variants of the selected part.
+
+        Note:
+        - This filter does nothing by itself, and requires the 'part' filter to be set.
+        - Refer to the 'filter_part' method for more information.
+        """
+        return queryset
+
+    part = rest_filters.ModelChoiceFilter(
+        queryset=Part.objects.all(), field_name='part', method='filter_part'
+    )
+
+    @extend_schema_field(OpenApiTypes.INT)
+    def filter_part(self, queryset, name, part):
+        """Filter by selected 'part'.
+
+        Note:
+        - If 'include_variants' is set to True, then all variants of the selected part will be included.
+        - Otherwise, just filter by the selected part.
+        """
+        include_variants = str2bool(self.data.get('include_variants', False))
+
+        if include_variants:
+            parts = part.get_descendants(include_self=True)
+        else:
+            parts = Part.objects.filter(pk=part.pk)
+
+        # Now that we have a queryset of parts, find all the matching return orders
+        line_items = models.TransferOrderLineItem.objects.filter(part__in=parts)
+
+        # Generate a list of ID values for the matching transfer orders
+        transfer_orders = line_items.values_list('order', flat=True).distinct()
+
+        # Now we have a list of matching IDs, filter the queryset
+        return queryset.filter(pk__in=transfer_orders)
+
+    completed_before = InvenTreeDateFilter(
+        label=_('Completed Before'), field_name='complete_date', lookup_expr='lt'
+    )
+
+    completed_after = InvenTreeDateFilter(
+        label=_('Completed After'), field_name='complete_date', lookup_expr='gt'
+    )
+
+
+class TransferOrderMixin(SerializerContextMixin):
+    """Mixin class for TransferOrder endpoints."""
+
+    queryset = models.TransferOrder.objects.all()
+    serializer_class = serializers.TransferOrderSerializer
+
+    def get_queryset(self, *args, **kwargs):
+        """Return annotated queryset for this endpoint."""
+        queryset = super().get_queryset(*args, **kwargs)
+        queryset = serializers.TransferOrderSerializer.annotate_queryset(queryset)
+        queryset = queryset.prefetch_related('created_by', 'responsible')
+
+        return queryset
+
+
+class TransferOrderList(
+    TransferOrderMixin,
+    OrderCreateMixin,
+    DataExportViewMixin,
+    OutputOptionsMixin,
+    ParameterListMixin,
+    ListCreateAPI,
+):
+    """API endpoint for accessing a list of TransferOrder objects."""
+
+    filterset_class = TransferOrderFilter
+    filter_backends = SEARCH_ORDER_FILTER
+
+    # TODO:
+    # output_options = TransferOrderOutputOptions
+
+    ordering_field_aliases = {
+        'reference': ['reference_int', 'reference'],
+        'project_code': ['project_code__code'],
+    }
+
+    ordering_fields = [
+        'creation_date',
+        'created_by',
+        'reference',
+        'line_items',
+        'status',
+        'start_date',
+        'target_date',
+        'complete_date',
+        'project_code',
+    ]
+
+    search_fields = ['reference', 'description', 'project_code__code']
+
+    ordering = '-reference'
+
+
+class TransferOrderDetail(
+    TransferOrderMixin, OutputOptionsMixin, RetrieveUpdateDestroyAPI
+):
+    """API endpoint for detail view of a single TransferOrder object."""
+
+    # output_options = TransferOrderOutputOptions
+
+
+class TransferOrderContextMixin:
+    """Simple mixin class to add a TransferOrder to the serializer context."""
+
+    queryset = models.TransferOrder.objects.all()
+
+    def get_serializer_context(self):
+        """Add the TransferOrder object to the serializer context."""
+        context = super().get_serializer_context()
+
+        # Pass the Transfer instance through to the serializer for validation
+        try:
+            context['order'] = models.TransferOrder.objects.get(
+                pk=self.kwargs.get('pk', None)
+            )
+        except Exception:
+            pass
+
+        context['request'] = self.request
+
+        return context
+
+
+class TransferOrderCancel(TransferOrderContextMixin, CreateAPI):
+    """API endpoint to cancel a TransferOrder."""
+
+    serializer_class = serializers.TransferOrderCancelSerializer
+
+
+class TransferOrderHold(TransferOrderContextMixin, CreateAPI):
+    """API endpoint to hold a TransferOrder."""
+
+    serializer_class = serializers.TransferOrderHoldSerializer
+
+
+class TransferOrderComplete(TransferOrderContextMixin, CreateAPI):
+    """API endpoint to complete a TransferOrder."""
+
+    serializer_class = serializers.TransferOrderCompleteSerializer
+
+
+class TransferOrderIssue(TransferOrderContextMixin, CreateAPI):
+    """API endpoint to issue a Transfer Order."""
+
+    serializer_class = serializers.TransferOrderIssueSerializer
+
+
+class TransferOrderAllocateSerials(TransferOrderContextMixin, CreateAPI):
+    """API endpoint to allocation stock items against a TransferOrder, by specifying serial numbers."""
+
+    queryset = models.TransferOrder.objects.none()
+    serializer_class = serializers.TransferOrderSerialAllocationSerializer
+
+
+class TransferOrderAllocate(TransferOrderContextMixin, CreateAPI):
+    """API endpoint to allocate stock items against a TransferOrder.
+
+    - The TransferOrder is specified in the URL
+    - See the TransferOrderAllocationSerializer class
+    """
+
+    queryset = models.TransferOrder.objects.none()
+    serializer_class = serializers.TransferOrderLineItemAllocationSerializer
+
+
+class TransferOrderAllocationFilter(FilterSet):
+    """Custom filterset for the TransferOrderAllocationList endpoint."""
+
+    class Meta:
+        """Metaclass options."""
+
+        model = models.TransferOrderAllocation
+        fields = ['line', 'item']
+
+    order = rest_filters.ModelChoiceFilter(
+        queryset=models.TransferOrder.objects.all(),
+        field_name='line__order',
+        label=_('Order'),
+    )
+
+    include_variants = rest_filters.BooleanFilter(
+        label=_('Include Variants'), method='filter_include_variants'
+    )
+
+    def filter_include_variants(self, queryset, name, value):
+        """Filter by whether or not to include variants of the selected part.
+
+        Note:
+        - This filter does nothing by itself, and requires the 'part' filter to be set.
+        - Refer to the 'filter_part' method for more information.
+        """
+        return queryset
+
+    part = rest_filters.ModelChoiceFilter(
+        queryset=Part.objects.all(), method='filter_part', label=_('Part')
+    )
+
+    @extend_schema_field(rest_framework.serializers.IntegerField(help_text=_('Part')))
+    def filter_part(self, queryset, name, part):
+        """Filter by the 'part' attribute.
+
+        Note:
+        - If "include_variants" is True, include all variants of the selected part
+        - Otherwise, just filter by the selected part
+        """
+        include_variants = str2bool(self.data.get('include_variants', False))
+
+        if include_variants:
+            parts = part.get_descendants(include_self=True)
+            return queryset.filter(item__part__in=parts)
+        else:
+            return queryset.filter(item__part=part)
+
+    outstanding = rest_filters.BooleanFilter(
+        label=_('Outstanding'), method='filter_outstanding'
+    )
+
+    def filter_outstanding(self, queryset, name, value):
+        """Filter by "outstanding" status (boolean)."""
+        if str2bool(value):
+            return queryset.filter(
+                line__order__status__in=TransferOrderStatusGroups.OPEN
+                # TODO: is there an additional filter here if we aren't using a "shipment"
+                # shipment__shipment_date=None,
+            )
+        return queryset.exclude(
+            # TODO: is there an additional filter here if we aren't using a "shipment"
+            # shipment__shipment_date=None,
+            line__order__status__in=TransferOrderStatusGroups.OPEN
+        )
+
+    location = rest_filters.ModelChoiceFilter(
+        queryset=stock_models.StockLocation.objects.all(),
+        label=_('Location'),
+        method='filter_location',
+    )
+
+    @extend_schema_field(
+        rest_framework.serializers.IntegerField(help_text=_('Location'))
+    )
+    def filter_location(self, queryset, name, location):
+        """Filter by the location of the allocated StockItem."""
+        locations = location.get_descendants(include_self=True)
+        return queryset.filter(item__location__in=locations)
+
+
+class TransferOrderAllocationMixin:
+    """Mixin class for TransferOrderAllocation endpoints."""
+
+    queryset = models.TransferOrderAllocation.objects.all()
+    serializer_class = serializers.TransferOrderAllocationSerializer
+
+    def get_queryset(self, *args, **kwargs):
+        """Annotate the queryset for this endpoint."""
+        queryset = super().get_queryset(*args, **kwargs)
+
+        queryset = queryset.prefetch_related(
+            'item',
+            'item__sales_order',
+            'item__part',
+            'line__part',
+            'item__location',
+            'line__order',
+            'line__order__responsible',
+            'line__order__project_code',
+            'line__order__project_code__responsible',
+        ).select_related('line__part__pricing_data', 'item__part__pricing_data')
+
+        return queryset
+
+
+class TransferOrderAllocationOutputOptions(OutputConfiguration):
+    """Output options for the TransferOrderAllocation endpoint."""
+
+    OPTIONS = [
+        InvenTreeOutputOption('part_detail'),
+        InvenTreeOutputOption('item_detail'),
+        InvenTreeOutputOption('order_detail'),
+        InvenTreeOutputOption('location_detail'),
+    ]
+
+
+class TransferOrderAllocationList(
+    TransferOrderAllocationMixin, BulkUpdateMixin, OutputOptionsMixin, ListAPI
+):
+    """API endpoint for listing TransferOrderAllocation objects."""
+
+    filterset_class = TransferOrderAllocationFilter
+    filter_backends = SEARCH_ORDER_FILTER
+    output_options = TransferOrderAllocationOutputOptions
+
+    ordering_fields = [
+        'quantity',
+        'part',
+        'serial',
+        'IPN',
+        'batch',
+        'location',
+        'order',
+    ]
+
+    ordering_field_aliases = {
+        'IPN': 'item__part__IPN',
+        'part': 'item__part__name',
+        'serial': ['item__serial_int', 'item__serial'],
+        'batch': 'item__batch',
+        'location': 'item__location__name',
+        'order': 'line__order__reference',
+    }
+
+    search_fields = {
+        'item__part__name',
+        'item__part__IPN',
+        'item__serial',
+        'item__batch',
+    }
+
+
+class TransferOrderAllocationDetail(
+    TransferOrderAllocationMixin, RetrieveUpdateDestroyAPI
+):
+    """API endpoint for detail view of a TransferOrderAllocation object."""
+
+
+class TransferOrderLineItemFilter(LineItemFilter):
+    """Custom filters for TransferOrderLineItemList endpoint."""
+
+    class Meta:
+        """Metaclass options."""
+
+        model = models.TransferOrderLineItem
+        fields = []
+
+    order = rest_filters.ModelChoiceFilter(
+        queryset=models.TransferOrder.objects.all(),
+        field_name='order',
+        label=_('Order'),
+    )
+
+    def filter_include_variants(self, queryset, name, value):
+        """Filter by whether or not to include variants of the selected part.
+
+        Note:
+        - This filter does nothing by itself, and requires the 'part' filter to be set.
+        - Refer to the 'filter_part' method for more information.
+        """
+        return queryset
+
+    part = rest_filters.ModelChoiceFilter(
+        queryset=Part.objects.all(),
+        field_name='part',
+        label=_('Part'),
+        method='filter_part',
+    )
+
+    @extend_schema_field(OpenApiTypes.INT)
+    def filter_part(self, queryset, name, part):
+        """Filter TransferOrderLineItem by selected 'part'.
+
+        Note:
+        - If 'include_variants' is set to True, then all variants of the selected part will be included.
+        - Otherwise, just filter by the selected part.
+        """
+        include_variants = str2bool(self.data.get('include_variants', False))
+
+        # Construct a queryset of parts to filter by
+        if include_variants:
+            parts = part.get_descendants(include_self=True)
+        else:
+            parts = Part.objects.filter(pk=part.pk)
+
+        return queryset.filter(part__in=parts)
+
+    allocated = rest_filters.BooleanFilter(
+        label=_('Allocated'), method='filter_allocated'
+    )
+
+    def filter_allocated(self, queryset, name, value):
+        """Filter by lines which are 'allocated'.
+
+        A line is 'allocated' when allocated >= quantity
+        """
+        q = Q(allocated__gte=F('quantity'))
+
+        if str2bool(value):
+            return queryset.filter(q)
+        return queryset.exclude(q)
+
+    completed = rest_filters.BooleanFilter(
+        label=_('Completed'), method='filter_completed'
+    )
+
+    def filter_completed(self, queryset, name, value):
+        """Filter by lines which are "completed".
+
+        A line is 'completed' when transferred >= quantity
+        """
+        q = Q(transferred__gte=F('quantity'))
+
+        if str2bool(value):
+            return queryset.filter(q)
+        return queryset.exclude(q)
+
+    order_complete = rest_filters.BooleanFilter(
+        label=_('Order Complete'), method='filter_order_complete'
+    )
+
+    def filter_order_complete(self, queryset, name, value):
+        """Filter by whether the order is 'complete' or not."""
+        if str2bool(value):
+            return queryset.filter(order__status__in=TransferOrderStatusGroups.COMPLETE)
+
+        return queryset.exclude(order__status__in=TransferOrderStatusGroups.COMPLETE)
+
+    order_outstanding = rest_filters.BooleanFilter(
+        label=_('Order Outstanding'), method='filter_order_outstanding'
+    )
+
+    def filter_order_outstanding(self, queryset, name, value):
+        """Filter by whether the order is 'outstanding' or not."""
+        if str2bool(value):
+            return queryset.filter(order__status__in=TransferOrderStatusGroups.OPEN)
+
+        return queryset.exclude(order__status__in=TransferOrderStatusGroups.OPEN)
+
+
+class TransferOrderLineItemMixin(SerializerContextMixin):
+    """Mixin class for TransferOrderLineItem endpoints."""
+
+    queryset = models.TransferOrderLineItem.objects.all()
+    serializer_class = serializers.TransferOrderLineItemSerializer
+
+    def get_queryset(self, *args, **kwargs):
+        """Return annotated queryset for this endpoint."""
+        queryset = super().get_queryset(*args, **kwargs)
+
+        queryset = queryset.prefetch_related(
+            'part',
+            'allocations',
+            # 'allocations__transfer',
+            'allocations__item__part',
+            'allocations__item__location',
+            'order',
+        )
+
+        queryset = serializers.TransferOrderLineItemSerializer.annotate_queryset(
+            queryset
+        )
+
+        return queryset
+
+
+class TransferOrderLineItemOutputOptions(OutputConfiguration):
+    """Output options for the TransferOrderAllocation endpoint."""
+
+    OPTIONS = [
+        InvenTreeOutputOption('part_detail'),
+        InvenTreeOutputOption('order_detail'),
+    ]
+
+
+class TransferOrderLineItemList(
+    TransferOrderLineItemMixin, DataExportViewMixin, OutputOptionsMixin, ListCreateAPI
+):
+    """API endpoint for accessing a list of TransferOrderLineItem objects."""
+
+    filterset_class = TransferOrderLineItemFilter
+
+    filter_backends = SEARCH_ORDER_FILTER
+
+    output_options = TransferOrderLineItemOutputOptions
+
+    ordering_fields = [
+        'order',
+        'part',
+        'part__name',
+        'quantity',
+        'allocated',
+        'transferred',
+        'reference',
+        'target_date',
+    ]
+
+    ordering_field_aliases = {'part': 'part__name', 'order': 'order__reference'}
+
+    search_fields = ['part__name', 'quantity', 'reference']
+
+
+class TransferOrderLineItemDetail(
+    TransferOrderLineItemMixin, OutputOptionsMixin, RetrieveUpdateDestroyAPI
+):
+    """API endpoint for detail view of a TransferOrderLineItem object."""
+
+    output_options = TransferOrderLineItemOutputOptions
+
+
 class OrderCalendarExport(ICalFeed):
     """Calendar export for Purchase/Sales Orders.
 
@@ -1844,6 +2361,8 @@ class OrderCalendarExport(ICalFeed):
             ordertype_title = _('Sales Order')
         elif obj['ordertype'] == 'return-order':
             ordertype_title = _('Return Order')
+        elif obj['ordertype'] == 'transfer-order':
+            ordertype_title = _('Transfer Order')
         else:
             ordertype_title = _('Unknown')
 
@@ -1889,6 +2408,15 @@ class OrderCalendarExport(ICalFeed):
                 ).filter(status__lt=ReturnOrderStatus.COMPLETE.value)
             else:
                 outlist = models.ReturnOrder.objects.filter(target_date__isnull=False)
+        elif obj['ordertype'] == 'transfer-order':
+            if obj['include_completed'] is False:
+                # Do not include completed orders from list in this case
+                # Complete status = 30
+                outlist = models.TransferOrder.objects.filter(
+                    target_date__isnull=False
+                ).filter(status__lt=TransferOrderStatus.COMPLETE.value)
+            else:
+                outlist = models.TransferOrder.objects.filter(target_date__isnull=False)
         else:
             outlist = []
 
@@ -1900,7 +2428,12 @@ class OrderCalendarExport(ICalFeed):
 
     def item_description(self, item):
         """Set the event description."""
-        return f'Company: {item.company.name}\nStatus: {item.get_status_display()}\nDescription: {item.description}'
+        if hasattr(item, 'company') and item.company:
+            return f'Company: {item.company.name}\nStatus: {item.get_status_display()}\nDescription: {item.description}'
+        else:
+            return (
+                f'Status: {item.get_status_display()}\nDescription: {item.description}'
+            )
 
     def item_start_datetime(self, item):
         """Set event start to target date. Goal is all-day event."""
@@ -2216,9 +2749,97 @@ order_api_urls = [
             ),
         ]),
     ),
+    # API endpoints for transfer orders
+    path(
+        'transfer-order/',
+        include([
+            # Transfer Order detail endpoints
+            path(
+                '<int:pk>/',
+                include([
+                    path(
+                        'allocate/',
+                        TransferOrderAllocate.as_view(),
+                        name='api-transfer-order-allocate',
+                    ),
+                    path(
+                        'allocate-serials/',
+                        TransferOrderAllocateSerials.as_view(),
+                        name='api-transfer-order-allocate-serials',
+                    ),
+                    path(
+                        'cancel/',
+                        TransferOrderCancel.as_view(),
+                        name='api-transfer-order-cancel',
+                    ),
+                    path(
+                        'hold/',
+                        TransferOrderHold.as_view(),
+                        name='api-transfer-order-hold',
+                    ),
+                    path(
+                        'complete/',
+                        TransferOrderComplete.as_view(),
+                        name='api-transfer-order-complete',
+                    ),
+                    path(
+                        'issue/',
+                        TransferOrderIssue.as_view(),
+                        name='api-transfer-order-issue',
+                    ),
+                    meta_path(models.TransferOrder),
+                    path(
+                        '',
+                        TransferOrderDetail.as_view(),
+                        name='api-transfer-order-detail',
+                    ),
+                ]),
+            ),
+            # Transfer Order list
+            path('', TransferOrderList.as_view(), name='api-transfer-order-list'),
+        ]),
+    ),
+    # API endpoints for transfer order line items
+    path(
+        'transfer-order-line/',
+        include([
+            path(
+                '<int:pk>/',
+                include([
+                    meta_path(models.TransferOrderLineItem),
+                    path(
+                        '',
+                        TransferOrderLineItemDetail.as_view(),
+                        name='api-transfer-order-line-detail',
+                    ),
+                ]),
+            ),
+            path(
+                '',
+                TransferOrderLineItemList.as_view(),
+                name='api-transfer-order-line-list',
+            ),
+        ]),
+    ),
+    # API endpoints for sales order allocations
+    path(
+        'transfer-order-allocation/',
+        include([
+            path(
+                '<int:pk>/',
+                TransferOrderAllocationDetail.as_view(),
+                name='api-transfer-order-allocation-detail',
+            ),
+            path(
+                '',
+                TransferOrderAllocationList.as_view(),
+                name='api-transfer-order-allocation-list',
+            ),
+        ]),
+    ),
     # API endpoint for subscribing to ICS calendar of purchase/sales/return orders
     re_path(
-        r'^calendar/(?P<ordertype>purchase-order|sales-order|return-order)/calendar.ics',
+        r'^calendar/(?P<ordertype>purchase-order|sales-order|return-order|transfer-order)/calendar.ics',
         OrderCalendarExport(),
         name='api-po-so-calendar',
     ),
diff --git a/src/backend/InvenTree/order/events.py b/src/backend/InvenTree/order/events.py
index 0d67a3e11b..4f17e26e35 100644
--- a/src/backend/InvenTree/order/events.py
+++ b/src/backend/InvenTree/order/events.py
@@ -37,3 +37,12 @@ class ReturnOrderEvents(BaseEventEnum):
     COMPLETED = 'returnorder.completed'
     CANCELLED = 'returnorder.cancelled'
     HOLD = 'returnorder.hold'
+
+
+class TransferOrderEvents(BaseEventEnum):
+    """Event enumeration for the PurchaseOrder models."""
+
+    ISSUED = 'transferorder.placed'
+    COMPLETED = 'transferorder.completed'
+    CANCELLED = 'transferorder.cancelled'
+    HOLD = 'transferorder.hold'
diff --git a/src/backend/InvenTree/order/fixtures/transfer_order.yaml b/src/backend/InvenTree/order/fixtures/transfer_order.yaml
new file mode 100644
index 0000000000..e4293d0f9a
--- /dev/null
+++ b/src/backend/InvenTree/order/fixtures/transfer_order.yaml
@@ -0,0 +1,68 @@
+- model: order.transferorder
+  pk: 1
+  fields:
+    reference: 'TO-123'
+    description: "One transfer order, please"
+    status: 10  # Pending
+
+- model: order.transferorder
+  pk: 2
+  fields:
+    reference: 'TO-124'
+    description: "One transfer order, please"
+    status: 40  # Cancelled
+
+- model: order.transferorder
+  pk: 3
+  fields:
+    reference: 'TO-125'
+    description: "One transfer order, please"
+    status: 25  # On Hold
+
+- model: order.transferorder
+  pk: 4
+  fields:
+    reference: 'TO-126'
+    description: "One transfer order, please"
+    status: 20  # Issued
+
+- model: order.transferorder
+  pk: 5
+  fields:
+    reference: 'TO-127'
+    description: "One transfer order, please"
+    status: 30  # Complete
+
+
+# Line items for transfer orders
+- model: order.transferorderlineitem
+  pk: 1
+  fields:
+    order: 5 # the completed order
+    part: 10001 # blue chair
+    quantity: 1
+
+- model: order.transferorderlineitem
+  pk: 2
+  fields:
+    order: 4 # the issued order
+    part: 10001 # blue chair
+    quantity: 1
+    transferred: 1
+
+# Allocations for transfer orders
+# an 'allocated' allocation
+- model: order.transferorderallocation
+  pk: 1
+  fields:
+    line: 1 # the line item on the completed order
+    item: 1 # stock item
+    quantity: 1
+
+# a 'complete' allocation
+- model: order.transferorderallocation
+  pk: 2
+  fields:
+    line: 2 # the line item on the issued order
+    item: 500 # stock item for the blue chair
+    quantity: 1
diff --git a/src/backend/InvenTree/order/migrations/0118_transferorder.py b/src/backend/InvenTree/order/migrations/0118_transferorder.py
new file mode 100644
index 0000000000..ddaf02c8c6
--- /dev/null
+++ b/src/backend/InvenTree/order/migrations/0118_transferorder.py
@@ -0,0 +1,482 @@
+# Generated by Django 5.2.11 on 2026-02-27 22:00
+
+import InvenTree.fields
+import InvenTree.models
+import django.core.validators
+import django.db.models.deletion
+import generic.states.fields
+import generic.states.states
+import generic.states.transition
+import generic.states.validators
+import order.status_codes
+import order.validators
+from django.conf import settings
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ("common", "0041_auto_20251203_1244"),
+        ("company", "0077_delete_manufacturerpartparameter"),
+        ("order", "0117_purchaseorderextraline_line_int_and_more"),
+        ("part", "0146_auto_20251203_1241"),
+        ("stock", "0116_alter_stockitem_link"),
+        ("users", "0005_owner_model"),
+        migrations.swappable_dependency(settings.AUTH_USER_MODEL),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name="TransferOrder",
+            fields=[
+                (
+                    "id",
+                    models.AutoField(
+                        auto_created=True,
+                        primary_key=True,
+                        serialize=False,
+                        verbose_name="ID",
+                    ),
+                ),
+                (
+                    "metadata",
+                    models.JSONField(
+                        blank=True,
+                        help_text="JSON metadata field, for use by external plugins",
+                        null=True,
+                        verbose_name="Plugin Metadata",
+                    ),
+                ),
+                ("reference_int", models.BigIntegerField(default=0)),
+                (
+                    "notes",
+                    InvenTree.fields.InvenTreeNotesField(
+                        blank=True,
+                        help_text="Markdown notes (optional)",
+                        max_length=50000,
+                        null=True,
+                        verbose_name="Notes",
+                    ),
+                ),
+                (
+                    "barcode_data",
+                    models.CharField(
+                        blank=True,
+                        help_text="Third party barcode data",
+                        max_length=500,
+                        verbose_name="Barcode Data",
+                    ),
+                ),
+                (
+                    "barcode_hash",
+                    models.CharField(
+                        blank=True,
+                        help_text="Unique hash of barcode data",
+                        max_length=128,
+                        verbose_name="Barcode Hash",
+                    ),
+                ),
+                (
+                    "description",
+                    models.CharField(
+                        blank=True,
+                        help_text="Order description (optional)",
+                        max_length=250,
+                        verbose_name="Description",
+                    ),
+                ),
+                (
+                    "link",
+                    InvenTree.fields.InvenTreeURLField(
+                        blank=True,
+                        help_text="Link to external page",
+                        max_length=2000,
+                        verbose_name="Link",
+                    ),
+                ),
+                (
+                    "start_date",
+                    models.DateField(
+                        blank=True,
+                        help_text="Scheduled start date for this order",
+                        null=True,
+                        verbose_name="Start date",
+                    ),
+                ),
+                (
+                    "target_date",
+                    models.DateField(
+                        blank=True,
+                        help_text="Expected date for order delivery. Order will be overdue after this date.",
+                        null=True,
+                        verbose_name="Target Date",
+                    ),
+                ),
+                (
+                    "creation_date",
+                    models.DateField(
+                        blank=True, null=True, verbose_name="Creation Date"
+                    ),
+                ),
+                (
+                    "issue_date",
+                    models.DateField(
+                        blank=True,
+                        help_text="Date order was issued",
+                        null=True,
+                        verbose_name="Issue Date",
+                    ),
+                ),
+                (
+                    "reference",
+                    models.CharField(
+                        default=order.validators.generate_next_transfer_order_reference,
+                        help_text="Transfer Order Reference",
+                        max_length=64,
+                        unique=True,
+                        validators=[order.validators.validate_transfer_order_reference],
+                        verbose_name="Reference",
+                    ),
+                ),
+                (
+                    "consume",
+                    models.BooleanField(
+                        default=False,
+                        help_text='Rather than transfer the stock to the destination, "consume" it, by removing transferred quantity from the allocated stock item',
+                        verbose_name="Consume Stock",
+                    ),
+                ),
+                (
+                    "complete_date",
+                    models.DateField(
+                        blank=True,
+                        help_text="Date order was completed",
+                        null=True,
+                        verbose_name="Completion Date",
+                    ),
+                ),
+                (
+                    "status_custom_key",
+                    generic.states.fields.ExtraInvenTreeCustomStatusModelField(
+                        blank=True,
+                        default=None,
+                        help_text="Additional status information for this item",
+                        null=True,
+                        validators=[
+                            generic.states.validators.CustomStatusCodeValidator(
+                                status_class=order.status_codes.TransferOrderStatus
+                            )
+                        ],
+                        verbose_name="Custom status key",
+                    ),
+                ),
+                (
+                    "status",
+                    generic.states.fields.InvenTreeCustomStatusModelField(
+                        choices=[
+                            (10, "Pending"),
+                            (20, "Issued"),
+                            (25, "On Hold"),
+                            (30, "Complete"),
+                            (40, "Cancelled"),
+                        ],
+                        default=10,
+                        help_text="Transfer order status",
+                        validators=[
+                            generic.states.validators.CustomStatusCodeValidator(
+                                status_class=order.status_codes.TransferOrderStatus
+                            )
+                        ],
+                        verbose_name="Status",
+                    ),
+                ),
+                (
+                    "address",
+                    models.ForeignKey(
+                        blank=True,
+                        help_text="Company address for this order",
+                        null=True,
+                        on_delete=django.db.models.deletion.SET_NULL,
+                        related_name="+",
+                        to="company.address",
+                        verbose_name="Address",
+                    ),
+                ),
+                (
+                    "contact",
+                    models.ForeignKey(
+                        blank=True,
+                        help_text="Point of contact for this order",
+                        null=True,
+                        on_delete=django.db.models.deletion.SET_NULL,
+                        related_name="+",
+                        to="company.contact",
+                        verbose_name="Contact",
+                    ),
+                ),
+                (
+                    "created_by",
+                    models.ForeignKey(
+                        blank=True,
+                        null=True,
+                        on_delete=django.db.models.deletion.SET_NULL,
+                        related_name="+",
+                        to=settings.AUTH_USER_MODEL,
+                        verbose_name="Created By",
+                    ),
+                ),
+                (
+                    "destination",
+                    models.ForeignKey(
+                        blank=True,
+                        help_text="Destination for transferred items",
+                        null=True,
+                        on_delete=django.db.models.deletion.SET_NULL,
+                        related_name="incoming_transfers",
+                        to="stock.stocklocation",
+                        verbose_name="Destination Location",
+                    ),
+                ),
+                (
+                    "project_code",
+                    models.ForeignKey(
+                        blank=True,
+                        help_text="Select project code for this order",
+                        null=True,
+                        on_delete=django.db.models.deletion.SET_NULL,
+                        to="common.projectcode",
+                        verbose_name="Project Code",
+                    ),
+                ),
+                (
+                    "responsible",
+                    models.ForeignKey(
+                        blank=True,
+                        help_text="User or group responsible for this order",
+                        null=True,
+                        on_delete=django.db.models.deletion.SET_NULL,
+                        related_name="+",
+                        to="users.owner",
+                        verbose_name="Responsible",
+                    ),
+                ),
+                (
+                    "take_from",
+                    models.ForeignKey(
+                        blank=True,
+                        help_text="Source for transferred items",
+                        null=True,
+                        on_delete=django.db.models.deletion.SET_NULL,
+                        related_name="sourcing_transfers",
+                        to="stock.stocklocation",
+                        verbose_name="Source Location",
+                    ),
+                ),
+                (
+                    "updated_at",
+                    models.DateTimeField(
+                        blank=True,
+                        help_text="Timestamp of last update",
+                        null=True,
+                        verbose_name="Updated At",
+                    ),
+                )
+            ],
+            options={
+                "verbose_name": "Transfer Order",
+            },
+            bases=(
+                generic.states.states.StatusCodeMixin,
+                generic.states.transition.StateTransitionMixin,
+                InvenTree.models.InvenTreeAttachmentMixin,
+                InvenTree.models.InvenTreePermissionCheckMixin,
+                InvenTree.models.ContentTypeMixin,
+                InvenTree.models.PluginValidationMixin,
+                models.Model,
+            ),
+        ),
+        migrations.CreateModel(
+            name="TransferOrderLineItem",
+            fields=[
+                (
+                    "id",
+                    models.AutoField(
+                        auto_created=True,
+                        primary_key=True,
+                        serialize=False,
+                        verbose_name="ID",
+                    ),
+                ),
+                (
+                    "metadata",
+                    models.JSONField(
+                        blank=True,
+                        help_text="JSON metadata field, for use by external plugins",
+                        null=True,
+                        verbose_name="Plugin Metadata",
+                    ),
+                ),
+                (
+                    "quantity",
+                    InvenTree.fields.RoundingDecimalField(
+                        decimal_places=5,
+                        default=1,
+                        help_text="Item quantity",
+                        max_digits=15,
+                        validators=[django.core.validators.MinValueValidator(0)],
+                        verbose_name="Quantity",
+                    ),
+                ),
+                (
+                    "reference",
+                    models.CharField(
+                        blank=True,
+                        help_text="Line item reference",
+                        max_length=100,
+                        verbose_name="Reference",
+                    ),
+                ),
+                (
+                    "notes",
+                    models.CharField(
+                        blank=True,
+                        help_text="Line item notes",
+                        max_length=500,
+                        verbose_name="Notes",
+                    ),
+                ),
+                (
+                    "link",
+                    InvenTree.fields.InvenTreeURLField(
+                        blank=True,
+                        help_text="Link to external page",
+                        max_length=2000,
+                        verbose_name="Link",
+                    ),
+                ),
+                (
+                    "target_date",
+                    models.DateField(
+                        blank=True,
+                        help_text="Target date for this line item (leave blank to use the target date from the order)",
+                        null=True,
+                        verbose_name="Target Date",
+                    ),
+                ),
+                (
+                    "order",
+                    models.ForeignKey(
+                        help_text="Transfer Order",
+                        on_delete=django.db.models.deletion.CASCADE,
+                        related_name="lines",
+                        to="order.transferorder",
+                        verbose_name="Order",
+                    ),
+                ),
+                (
+                    "part",
+                    models.ForeignKey(
+                        help_text="Part",
+                        null=True,
+                        on_delete=django.db.models.deletion.SET_NULL,
+                        related_name="transfer_order_line_items",
+                        to="part.part",
+                        verbose_name="Part",
+                    ),
+                ),
+                (
+                    "project_code",
+                    models.ForeignKey(
+                        blank=True,
+                        help_text="Select project code for this order",
+                        null=True,
+                        on_delete=django.db.models.deletion.SET_NULL,
+                        to="common.projectcode",
+                        verbose_name="Project Code",
+                    ),
+                ),
+                (
+                    "transferred",
+                    InvenTree.fields.RoundingDecimalField(
+                        decimal_places=5,
+                        default=0,
+                        help_text="transferred quantity",
+                        max_digits=15,
+                        validators=[django.core.validators.MinValueValidator(0)],
+                        verbose_name="transferred",
+                    ),
+                ),
+                (
+                    "line",
+                    models.CharField(
+                        blank=True,
+                        default="",
+                        help_text="Line number for this item (optional)",
+                        max_length=20,
+                        verbose_name="Line Number",
+                    ),
+                )
+            ],
+            options={
+                "verbose_name": "Transfer Order Line Item",
+            },
+            bases=(
+                InvenTree.models.ContentTypeMixin,
+                InvenTree.models.PluginValidationMixin,
+                models.Model,
+            ),
+        ),
+        migrations.CreateModel(
+            name="TransferOrderAllocation",
+            fields=[
+                (
+                    "id",
+                    models.AutoField(
+                        auto_created=True,
+                        primary_key=True,
+                        serialize=False,
+                        verbose_name="ID",
+                    ),
+                ),
+                (
+                    "quantity",
+                    InvenTree.fields.RoundingDecimalField(
+                        decimal_places=5,
+                        default=1,
+                        help_text="Enter stock allocation quantity",
+                        max_digits=15,
+                        validators=[django.core.validators.MinValueValidator(0)],
+                        verbose_name="Quantity",
+                    ),
+                ),
+                (
+                    "item",
+                    models.ForeignKey(
+                        help_text="Select stock item to allocate",
+                        limit_choices_to={
+                            "belongs_to": None,
+                            "part__virtual": False,
+                            "sales_order": None,
+                        },
+                        on_delete=django.db.models.deletion.CASCADE,
+                        related_name="transfer_order_allocations",
+                        to="stock.stockitem",
+                        verbose_name="Item",
+                    ),
+                ),
+                (
+                    "line",
+                    models.ForeignKey(
+                        on_delete=django.db.models.deletion.CASCADE,
+                        related_name="allocations",
+                        to="order.transferorderlineitem",
+                        verbose_name="Line",
+                    ),
+                ),
+            ],
+            options={
+                "verbose_name": "Transfer Order Allocation",
+            },
+        ),
+    ]
diff --git a/src/backend/InvenTree/order/migrations/0119_transferorderlineitem_line_int.py b/src/backend/InvenTree/order/migrations/0119_transferorderlineitem_line_int.py
new file mode 100644
index 0000000000..e9ad06975c
--- /dev/null
+++ b/src/backend/InvenTree/order/migrations/0119_transferorderlineitem_line_int.py
@@ -0,0 +1,18 @@
+# Generated by Django 5.2.13 on 2026-05-11 21:37
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ("order", "0118_transferorder"),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name="transferorderlineitem",
+            name="line_int",
+            field=models.IntegerField(default=0),
+        ),
+    ]
diff --git a/src/backend/InvenTree/order/models.py b/src/backend/InvenTree/order/models.py
index c597e8c011..5973f4292b 100644
--- a/src/backend/InvenTree/order/models.py
+++ b/src/backend/InvenTree/order/models.py
@@ -45,7 +45,12 @@ from InvenTree.fields import (
 )
 from InvenTree.helpers import decimal2string, pui_url
 from InvenTree.helpers_model import notify_responsible
-from order.events import PurchaseOrderEvents, ReturnOrderEvents, SalesOrderEvents
+from order.events import (
+    PurchaseOrderEvents,
+    ReturnOrderEvents,
+    SalesOrderEvents,
+    TransferOrderEvents,
+)
 from order.status_codes import (
     PurchaseOrderStatus,
     PurchaseOrderStatusGroups,
@@ -54,6 +59,8 @@ from order.status_codes import (
     ReturnOrderStatusGroups,
     SalesOrderStatus,
     SalesOrderStatusGroups,
+    TransferOrderStatus,
+    TransferOrderStatusGroups,
 )
 from part import models as PartModels
 from plugin.events import trigger_event
@@ -265,6 +272,27 @@ class ReturnOrderReportContext(report.mixins.BaseReportContext, TypedDict):
     customer: Optional[Company]
 
 
+class TransferOrderReportContext(report.mixins.BaseReportContext, TypedDict):
+    """Context for the transfer order model.
+
+    Attributes:
+        description: The description field of the TransferOrder
+        reference: The reference field of the TransferOrder
+        title: The title (string representation) of the TransferOrder
+        lines: Query set of all line items associated with the TransferOrder
+        order: The TransferOrder instance itself
+    """
+
+    description: str
+    reference: str
+    title: str
+    lines: report.mixins.QuerySet['TransferOrderLineItem']
+    order: 'TransferOrder'
+    take_from: 'stock.models.StockLocation'
+    destination: 'stock.models.StockLocation'
+    consume: bool
+
+
 class Order(
     StatusCodeMixin,
     StateTransitionMixin,
@@ -374,11 +402,16 @@ class Order(
                     })
 
         # Check that the referenced 'contact' matches the correct 'company'
-        if self.company and self.contact:
-            if self.contact.company != self.company:
-                raise ValidationError({
-                    'contact': _('Contact does not match selected company')
-                })
+        if (
+            hasattr(self, 'company')
+            and hasattr(self, 'contact')
+            and self.company
+            and self.contact
+            and (self.contact.company != self.company)
+        ):
+            raise ValidationError({
+                'contact': _('Contact does not match selected company')
+            })
 
         # Target date should be *after* the start date
         if self.start_date and self.target_date and self.start_date > self.target_date:
@@ -388,11 +421,15 @@ class Order(
             })
 
         # Check that the referenced 'address' matches the correct 'company'
-        if self.company and self.address:
-            if self.address.company != self.company:
-                raise ValidationError({
-                    'address': _('Address does not match selected company')
-                })
+        if (
+            hasattr(self, 'company')
+            and self.company
+            and self.address
+            and (self.address.company != self.company)
+        ):
+            raise ValidationError({
+                'address': _('Address does not match selected company')
+            })
 
     def clean_line_item(self, line):
         """Clean a line item for this order.
@@ -408,7 +445,9 @@ class Order(
         """Generate context data for the reporting interface."""
         return {
             'description': self.description,
-            'extra_lines': self.extra_lines,
+            'extra_lines': getattr(
+                self, 'extra_lines', None
+            ),  # Transfer Order doesn't have extra lines
             'lines': self.lines,
             'order': self,
             'reference': self.reference,
@@ -3155,6 +3194,628 @@ class ReturnOrderExtraLine(OrderExtraLine):
     )
 
 
+class TransferOrder(Order):
+    """A Transfer Order represents a request to transfer stock from one location to another. It provides a place to queue and review changes before execution.
+
+    Attributes:
+        take_from: The stock location to source items from (or null to )
+        destination: The stock location to move items to
+        consume: Rather than move the stock, "consume" it. Helpful if you want to queue up removing stock from inventory
+    """
+
+    # Global setting for specifying reference pattern
+    REFERENCE_PATTERN_SETTING = 'TRANSFERORDER_REFERENCE_PATTERN'
+    REQUIRE_RESPONSIBLE_SETTING = 'TRANSFERORDER_REQUIRE_RESPONSIBLE'
+    STATUS_CLASS = TransferOrderStatus
+    # UNLOCK_SETTING = 'TRANSFERORDER_EDIT_COMPLETED_ORDERS'
+
+    class Meta:
+        """Model meta options."""
+
+        verbose_name = _('Transfer Order')
+
+    def report_context(self) -> TransferOrderReportContext:
+        """Return report context data for this TransferOrder."""
+        return {
+            **super().report_context(),
+            'take_from': self.take_from,
+            'destination': self.destination,
+            'consume': self.consume,
+        }
+
+    def get_absolute_url(self) -> str:
+        """Get the 'web' URL for this order."""
+        return pui_url(f'/stock/transfer-order/{self.pk}')
+
+    @staticmethod
+    def get_api_url() -> str:
+        """Return the API URL associated with the TransferOrder model."""
+        return reverse('api-transfer-order-list')
+
+    @classmethod
+    def get_status_class(cls):
+        """Return the TransferOrderStatus class."""
+        return TransferOrderStatusGroups
+
+    @classmethod
+    def api_defaults(cls, request=None):
+        """Return default values for this model when issuing an API OPTIONS request."""
+        defaults = {
+            'reference': order.validators.generate_next_transfer_order_reference()
+        }
+
+        return defaults
+
+    @classmethod
+    def barcode_model_type_code(cls):
+        """Return the associated barcode model type code for this model."""
+        return 'TO'
+
+    def subscribed_users(self) -> list[User]:
+        """Return a list of users subscribed to this TransferOrder.
+
+        By this, we mean users to are interested in any of the parts associated with this order.
+        """
+        subscribed_users = set()
+
+        for line in self.lines.all():
+            if line.part:
+                # Add the part to the list of subscribed users
+                for user in line.part.get_subscribers():
+                    subscribed_users.add(user)
+
+        return list(subscribed_users)
+
+    def clean_line_item(self, line):
+        """Clean a line item for this PurchaseOrder."""
+        super().clean_line_item(line)
+        line.transferred = 0
+
+    def __str__(self):
+        """Render a string representation of this TransferOrder."""
+        return f'{self.reference} - {self.take_from.name if self.take_from else _("deleted")} --> {self.destination.name if self.destination else _("deleted")}'
+
+    reference = models.CharField(
+        unique=True,
+        max_length=64,
+        blank=False,
+        help_text=_('Transfer Order Reference'),
+        verbose_name=_('Reference'),
+        default=order.validators.generate_next_transfer_order_reference,
+        validators=[order.validators.validate_transfer_order_reference],
+    )
+
+    status = InvenTreeCustomStatusModelField(
+        default=TransferOrderStatus.PENDING.value,
+        choices=TransferOrderStatus.items(),
+        status_class=TransferOrderStatus,
+        verbose_name=_('Status'),
+        help_text=_('Transfer order status'),
+    )
+
+    @property
+    def status_text(self):
+        """Return the text representation of the status field."""
+        return TransferOrderStatus.text(self.status)
+
+    take_from = models.ForeignKey(
+        'stock.StockLocation',
+        verbose_name=_('Source Location'),
+        on_delete=models.SET_NULL,
+        related_name='sourcing_transfers',
+        blank=True,
+        null=True,
+        help_text=_('Source for transferred items'),
+    )
+
+    destination = models.ForeignKey(
+        'stock.StockLocation',
+        verbose_name=_('Destination Location'),
+        on_delete=models.SET_NULL,
+        related_name='incoming_transfers',
+        blank=True,
+        null=True,
+        help_text=_('Destination for transferred items'),
+    )
+
+    consume = models.BooleanField(
+        default=False,
+        verbose_name=_('Consume Stock'),
+        help_text=_(
+            'Rather than transfer the stock to the destination, "consume" it, by removing transferred quantity from the allocated stock item'
+        ),
+    )
+
+    complete_date = models.DateField(
+        blank=True,
+        null=True,
+        verbose_name=_('Completion Date'),
+        help_text=_('Date order was completed'),
+    )
+
+    @property
+    def company(self) -> None:
+        """Required accessor helper for Order base class."""
+        return None
+
+    @property
+    def is_pending(self) -> bool:
+        """Return True if the TransferOrder is 'pending'."""
+        return self.status == TransferOrderStatus.PENDING.value
+
+    @property
+    def is_open(self) -> bool:
+        """Return True if the TransferOrder is 'open'."""
+        return self.status in TransferOrderStatusGroups.OPEN
+
+    @property
+    def stock_allocations(self) -> QuerySet:
+        """Return a queryset containing all allocations for this order."""
+        return TransferOrderAllocation.objects.filter(
+            line__in=[line.pk for line in self.lines.all()]
+        )
+
+    def is_fully_allocated(self) -> bool:
+        """Return True if all line items are fully allocated."""
+        return all(line.is_fully_allocated() for line in self.lines.all())
+
+    def is_overallocated(self) -> bool:
+        """Return true if any lines in the order are over-allocated."""
+        return any(line.is_overallocated() for line in self.lines.all())
+
+    def is_completed(self) -> bool:
+        """Check if this order is "transferred" (all line items transferred)."""
+        return all(line.is_completed() for line in self.lines.all())
+
+    def can_complete(
+        self, raise_error: bool = False, allow_incomplete_lines: bool = False
+    ) -> bool:
+        """Test if this TransferOrder can be completed."""
+        try:
+            if self.status == TransferOrderStatus.COMPLETE.value:
+                raise ValidationError(_('Order is already complete'))
+
+            if self.status == TransferOrderStatus.CANCELLED.value:
+                raise ValidationError(_('Order is already cancelled'))
+
+            if not self.consume and not self.destination:
+                raise ValidationError(
+                    _('Order cannot be completed until a destination location is set')
+                )
+
+            if not (self.is_fully_allocated() or allow_incomplete_lines):
+                raise ValidationError(
+                    _('Order cannot be completed until it is fully allocated')
+                )
+        except ValidationError as e:
+            if raise_error:
+                raise e
+            else:
+                return False
+
+        return True
+
+    @property
+    def can_issue(self) -> bool:
+        """Return True if this order can be issued."""
+        return self.status in [
+            TransferOrderStatus.PENDING.value,
+            TransferOrderStatus.ON_HOLD.value,
+        ]
+
+    @transaction.atomic
+    def issue_order(self):
+        """Attempt to transition to PLACED status."""
+        return self.handle_transition(
+            self.status, TransferOrderStatus.ISSUED.value, self, self._action_issue
+        )
+
+    # region state changes
+    def _action_issue(self, *args, **kwargs):
+        """Marks the TransferOrder as ISSUED.
+
+        Order must be currently PENDING.
+        """
+        if self.can_issue:
+            self.status = TransferOrderStatus.ISSUED.value
+            self.issue_date = InvenTree.helpers.current_date()
+            self.save()
+
+            trigger_event(TransferOrderEvents.ISSUED, id=self.pk)
+
+            # Notify users that the order has been issued
+            notify_responsible(
+                self,
+                TransferOrder,
+                exclude=self.created_by,
+                content=InvenTreeNotificationBodies.NewOrder,
+                extra_users=self.subscribed_users(),
+            )
+
+    @property
+    def can_hold(self) -> bool:
+        """Return True if this order can be placed on hold."""
+        return self.status in [
+            TransferOrderStatus.PENDING.value,
+            TransferOrderStatus.ISSUED.value,
+        ]
+
+    def _action_hold(self, *args, **kwargs):
+        """Mark this transfer order as 'on hold'."""
+        if self.can_hold:
+            self.status = TransferOrderStatus.ON_HOLD.value
+            self.save()
+
+            trigger_event(TransferOrderEvents.HOLD, id=self.pk)
+
+    @transaction.atomic
+    def _action_complete(self, *args, **kwargs):
+        """Marks the TransferOrder as COMPLETE.
+
+        Order must be currently ISSUED.
+        """
+        user = kwargs.pop('user', None)
+
+        if not self.can_complete(raise_error=True, **kwargs):
+            return False
+
+        if self.status == TransferOrderStatus.ISSUED:
+            for allocation in self.allocations():
+                # execute each transfer
+                allocation.complete_allocation(user)
+
+            self.status = TransferOrderStatus.COMPLETE.value
+            self.complete_date = InvenTree.helpers.current_date()
+
+            self.save()
+
+            trigger_event(TransferOrderEvents.COMPLETED, id=self.pk)
+
+            return True
+
+    @transaction.atomic
+    def complete_order(self, user, **kwargs):
+        """Attempt to transition to COMPLETE status."""
+        return self.handle_transition(
+            self.status,
+            TransferOrderStatus.COMPLETE.value,
+            self,
+            self._action_complete,
+            user=user,
+            **kwargs,
+        )
+
+    @transaction.atomic
+    def hold_order(self):
+        """Attempt to transition to ON_HOLD status."""
+        return self.handle_transition(
+            self.status, TransferOrderStatus.ON_HOLD.value, self, self._action_hold
+        )
+
+    @transaction.atomic
+    def cancel_order(self):
+        """Attempt to transition to CANCELLED status."""
+        return self.handle_transition(
+            self.status, TransferOrderStatus.CANCELLED.value, self, self._action_cancel
+        )
+
+    @property
+    def can_cancel(self) -> bool:
+        """A TransferOrder can only be cancelled under the following circumstances.
+
+        - Status is ISSUED
+        - Status is PENDING (or ON_HOLD)
+        """
+        return self.status in TransferOrderStatusGroups.OPEN
+
+    def _action_cancel(self, *args, **kwargs):
+        """Cancel this TransferOrder (only if we're allowed to).
+
+        Executes:
+        - Mark the order as 'cancelled'
+        - Delete any StockItems which have been allocated
+        """
+        if not self.can_cancel:
+            return False
+
+        self.status = TransferOrderStatus.CANCELLED.value
+        self.save()
+
+        # delete allocations
+        for line in self.lines.all():
+            for allocation in line.allocations.all():
+                allocation.delete()
+
+        trigger_event(TransferOrderEvents.CANCELLED, id=self.pk)
+
+        # Notify users that the order has been canceled
+        notify_responsible(
+            self,
+            TransferOrder,
+            exclude=self.created_by,
+            content=InvenTreeNotificationBodies.OrderCanceled,
+            extra_users=self.subscribed_users(),
+        )
+
+    # endregion
+
+    @property
+    def line_count(self) -> int:
+        """Return the total number of lines associated with this order."""
+        return self.lines.count()
+
+    def completed_line_items(self) -> QuerySet:
+        """Return a queryset of the completed line items for this order."""
+        return self.lines.filter(transferred__gte=F('quantity'))
+
+    def pending_line_items(self) -> QuerySet:
+        """Return a queryset of the pending line items for this order."""
+        return self.lines.filter(transferred__lt=F('quantity'))
+
+    @property
+    def completed_line_count(self) -> int:
+        """Return the number of completed lines for this order."""
+        return self.completed_line_items().count()
+
+    @property
+    def pending_line_count(self) -> int:
+        """Return the number of pending (incomplete) lines associated with this order."""
+        return self.pending_line_items().count()
+
+    def allocations(self) -> QuerySet:
+        """Return a queryset of all allocations for this order."""
+        return TransferOrderAllocation.objects.filter(line__order=self)
+
+
+class TransferOrderLineItem(OrderLineItem):
+    """Model for a single LineItem in a TransferOrder.
+
+    Attributes:
+        order: Link to the TransferOrder that this line item belongs to
+        part: Link to a Part object (may be null)
+        transferred: The number of items which have actually transferred against this line item
+    """
+
+    class Meta:
+        """Model meta options."""
+
+        verbose_name = _('Transfer Order Line Item')
+
+    # Filter for determining if a particular TransferOrderLineItem is overdue
+    OVERDUE_FILTER = (
+        Q(transferred__lt=F('quantity'))
+        & ~Q(target_date=None)
+        & Q(target_date__lt=InvenTree.helpers.current_date())
+    )
+
+    @staticmethod
+    def get_api_url():
+        """Return the API URL associated with the TransferOrderLineItem model."""
+        return reverse('api-transfer-order-line-list')
+
+    order = models.ForeignKey(
+        TransferOrder,
+        on_delete=models.CASCADE,
+        related_name='lines',
+        verbose_name=_('Order'),
+        help_text=_('Transfer Order'),
+    )
+
+    part = models.ForeignKey(
+        'part.Part',
+        on_delete=models.SET_NULL,
+        related_name='transfer_order_line_items',
+        null=True,
+        verbose_name=_('Part'),
+        help_text=_('Part'),
+        # limit_choices_to={'salable': True},
+    )
+
+    transferred = RoundingDecimalField(
+        verbose_name=_('transferred'),
+        help_text=_('transferred quantity'),
+        default=0,
+        max_digits=15,
+        decimal_places=5,
+        validators=[MinValueValidator(0)],
+    )
+
+    def allocated_quantity(self):
+        """Return the total stock quantity allocated to this LineItem.
+
+        This is a summation of the quantity of each attached StockItem
+        """
+        if not self.pk:
+            return 0
+
+        query = self.allocations.aggregate(
+            allocated=Coalesce(Sum('quantity'), Decimal(0))
+        )
+
+        return query['allocated']
+
+    def is_fully_allocated(self) -> bool:
+        """Return True if this line item is fully allocated."""
+        # If the linked part is "virtual", then we cannot allocate stock against it
+        if self.part and self.part.virtual:
+            return True
+
+        return self.allocated_quantity() >= self.quantity
+
+    def is_overallocated(self) -> bool:
+        """Return True if this line item is over allocated."""
+        return self.allocated_quantity() > self.quantity
+
+    def is_completed(self) -> bool:
+        """Return True if this line item is completed (has been fully shipped)."""
+        # A "virtual" part is always considered to be "completed"
+        if self.part and self.part.virtual:
+            return True
+
+        return self.transferred >= self.quantity
+
+
+class TransferOrderAllocation(models.Model):
+    """This model is used to 'allocate' stock items to a TransferOrder. Items that are "allocated" to a TransferOrder are not yet "attached" to the order, but they will be once the order is fulfilled.
+
+    Attributes:
+        line: TransferOrderLineItem reference
+        item: StockItem reference
+        quantity: Quantity to take from the StockItem
+    """
+
+    class Meta:
+        """Model meta options."""
+
+        verbose_name = _('Transfer Order Allocation')
+
+    @staticmethod
+    def get_api_url():
+        """Return the API URL associated with the TransferOrderAllocation model."""
+        return reverse('api-transfer-order-allocation-list')
+
+    def clean(self):
+        """Validate the TransferOrderAllocation object.
+
+        Executes:
+        - Cannot allocate stock to a line item without a part reference
+        - The referenced part must match the part associated with the line item
+        - Allocated quantity cannot exceed the quantity of the stock item
+        - Allocation quantity must be "1" if the StockItem is serialized
+        - Allocation quantity cannot be zero
+        """
+        super().clean()
+
+        errors = {}
+
+        try:
+            if not self.item:
+                raise ValidationError({'item': _('Stock item has not been assigned')})
+        except stock.models.StockItem.DoesNotExist:
+            raise ValidationError({'item': _('Stock item has not been assigned')})
+
+        try:
+            if self.line.part != self.item.part:
+                variants = self.line.part.get_descendants(include_self=True)
+                if self.line.part not in variants:
+                    errors['item'] = _(
+                        'Cannot allocate stock item to a line with a different part'
+                    )
+        except PartModels.Part.DoesNotExist:
+            errors['line'] = _('Cannot allocate stock to a line without a part')
+
+        if self.quantity > self.item.quantity:
+            errors['quantity'] = _('Allocation quantity cannot exceed stock quantity')
+
+        # Ensure that we do not 'over allocate' a stock item
+        build_allocation_count = self.item.build_allocation_count()
+        sales_allocation_count = self.item.sales_order_allocation_count(
+            exclude_allocations={'pk': self.pk}
+        )
+
+        total_allocation = (
+            build_allocation_count + sales_allocation_count + self.quantity
+        )
+
+        if total_allocation > self.item.quantity:
+            errors['quantity'] = _('Stock item is over-allocated')
+
+        if self.quantity <= 0:
+            errors['quantity'] = _('Allocation quantity must be greater than zero')
+
+        if self.item.serial and self.quantity != 1:
+            errors['quantity'] = _('Quantity must be 1 for serialized stock item')
+
+        if len(errors) > 0:
+            raise ValidationError(errors)
+
+    line = models.ForeignKey(
+        TransferOrderLineItem,
+        on_delete=models.CASCADE,
+        verbose_name=_('Line'),
+        related_name='allocations',
+    )
+
+    item = models.ForeignKey(
+        'stock.StockItem',
+        on_delete=models.CASCADE,
+        related_name='transfer_order_allocations',
+        limit_choices_to={
+            'part__virtual': False,
+            'belongs_to': None,
+            'sales_order': None,
+        },
+        verbose_name=_('Item'),
+        help_text=_('Select stock item to allocate'),
+    )
+
+    quantity = RoundingDecimalField(
+        max_digits=15,
+        decimal_places=5,
+        validators=[MinValueValidator(0)],
+        default=1,
+        verbose_name=_('Quantity'),
+        help_text=_('Enter stock allocation quantity'),
+    )
+
+    def get_location(self):
+        """Return the <pk> value of the location associated with this allocation."""
+        return self.item.location.id if self.item.location else None
+
+    def get_po(self):
+        """Return the PurchaseOrder associated with this allocation."""
+        return self.item.purchase_order
+
+    def complete_allocation(self, user):
+        """Complete this allocation (called when the parent TransferOrder is marked as "completed").
+
+        Executes:
+        - Determine if the referenced StockItem needs to be "split" (if allocated quantity != stock quantity)
+        - Move the StockItem to the new location
+        - Updates the transferred qty
+        - If order is marked as "consume", reduce quantity rather than move
+        """
+        order: TransferOrder = self.line.order
+        self.item: stock.models.StockItem  # for type hints
+        self.line: TransferOrderLineItem  # for type hints
+
+        # The allocation is the only thing linking this stock item to the transfer
+        # As a result, we must keep the allocation present even after completion
+        # This means allocations to transfer orders don't affect "available" stock
+        # (otherwise it would permanently reduce available stock)
+
+        if order.consume:
+            # rather than transferring the stock, we simply reduce its quantity to release it from tracked inventory
+            # NOTE: if delete_on_deplete is enabled, this will result in the "transferred stock" panel being empty
+            #       after completion. A more sophesticated immutable tracking that doesn't rely on allocations
+            #       would be helpful here
+            self.item.take_stock(
+                quantity=self.quantity,
+                user=user,
+                code=StockHistoryCode.STOCK_REMOVE,
+                transferorder=order,
+            )
+        else:
+            if self.quantity < self.item.quantity:
+                # update our own reference to the StockItem which was split
+                self.item = self.item.splitStock(
+                    quantity=self.quantity,
+                    location=order.destination,
+                    user=user,
+                    transferorder=order,
+                )
+                self.save()
+            else:
+                # move item directly, we don't have to split
+                self.item.move(
+                    location=order.destination, user=user, transferorder=order, notes=''
+                )
+
+        # Update the transferred qty
+        self.line.transferred += self.quantity
+        self.line.save()
+
+
 def _touch_order_updated_at(instance):
     """Bump updated_at on the parent order without triggering a full save."""
     if not InvenTree.ready.canAppAccessDatabase(allow_test=True):
@@ -3190,6 +3851,16 @@ def _touch_order_updated_at(instance):
 @receiver(
     post_delete, sender=ReturnOrderExtraLine, dispatch_uid='ro_extraline_post_delete'
 )
+@receiver(
+    post_save,
+    sender=TransferOrderLineItem,
+    dispatch_uid='transfer_order_lineitem_post_save',
+)
+@receiver(
+    post_delete,
+    sender=TransferOrderLineItem,
+    dispatch_uid='transfer_order_lineitem_post_delete',
+)
 def update_order_on_lineitem_change(sender, instance, **kwargs):
     """Update parent order updated_at when any line item is saved or deleted."""
     _touch_order_updated_at(instance)
diff --git a/src/backend/InvenTree/order/serializers.py b/src/backend/InvenTree/order/serializers.py
index 80a2765b03..c2d1b909ac 100644
--- a/src/backend/InvenTree/order/serializers.py
+++ b/src/backend/InvenTree/order/serializers.py
@@ -44,6 +44,7 @@ from order.status_codes import (
     ReturnOrderLineStatus,
     ReturnOrderStatus,
     SalesOrderStatusGroups,
+    TransferOrderStatusGroups,
 )
 from part.serializers import PartBriefSerializer
 from stock.status_codes import StockStatus
@@ -2298,3 +2299,622 @@ class ReturnOrderExtraLineSerializer(
             'allow_null': True,
         },
     )
+
+
+@register_importer()
+class TransferOrderSerializer(
+    NotesFieldMixin,
+    InvenTreeCustomStatusSerializerMixin,
+    AbstractOrderSerializer,
+    InvenTreeModelSerializer,
+):
+    """Serializer for a TransferOrder object."""
+
+    class Meta:
+        """Metaclass options."""
+
+        model = order.models.TransferOrder
+        fields = AbstractOrderSerializer.order_fields([
+            'take_from',
+            'take_from_detail',
+            'destination',
+            'destination_detail',
+            'consume',
+            'complete_date',
+        ])
+        read_only_fields = ['creation_date']
+        extra_kwargs = {}
+
+    def skip_create_fields(self):
+        """Skip these fields when instantiating a new object."""
+        fields = super().skip_create_fields()
+
+        return [*fields, 'duplicate']
+
+    @staticmethod
+    def annotate_queryset(queryset):
+        """Add extra information to the queryset.
+
+        - Number of line items in the TransferOrder
+        - Number of completed line items in the TransferOrder
+        - Overdue status of the TransferOrder
+        """
+        queryset = AbstractOrderSerializer.annotate_queryset(queryset)
+
+        queryset = queryset.annotate(
+            completed_lines=SubqueryCount(
+                'lines', filter=Q(quantity__lte=F('transferred'))
+            )
+        )
+
+        queryset = queryset.annotate(
+            overdue=Case(
+                When(
+                    order.models.TransferOrder.overdue_filter(),
+                    then=Value(True, output_field=BooleanField()),
+                ),
+                default=Value(False, output_field=BooleanField()),
+            )
+        )
+
+        return queryset
+
+    take_from_detail = OptionalField(
+        serializer_class=stock.serializers.LocationSerializer,
+        serializer_kwargs={
+            'source': 'take_from',
+            'many': False,
+            'read_only': True,
+            'allow_null': True,
+        },
+        default_include=True,
+    )
+
+    destination_detail = OptionalField(
+        serializer_class=stock.serializers.LocationSerializer,
+        serializer_kwargs={
+            'source': 'destination',
+            'many': False,
+            'read_only': True,
+            'allow_null': True,
+        },
+        default_include=True,
+    )
+
+
+class TransferOrderHoldSerializer(OrderAdjustSerializer):
+    """Serializer for placing a TransferOrder on hold."""
+
+    def save(self):
+        """Save the serializer to 'hold' the order."""
+        self.order.hold_order()
+
+
+class TransferOrderIssueSerializer(OrderAdjustSerializer):
+    """Serializer for issuing a transfer order."""
+
+    def save(self):
+        """Save the serializer to 'issue' the order."""
+        self.order.issue_order()
+
+
+class TransferOrderCancelSerializer(OrderAdjustSerializer):
+    """Serializer for cancelling a TransferOrder."""
+
+    def save(self):
+        """Save the serializer to 'cancel' the order."""
+        if not self.order.can_cancel:
+            raise ValidationError(_('Order cannot be cancelled'))
+
+        self.order.cancel_order()
+
+
+class TransferOrderCompleteSerializer(OrderAdjustSerializer):
+    """Serializer for completing a transfer order."""
+
+    class Meta:
+        """Metaclass options."""
+
+        fields = ['accept_incomplete_allocation']
+
+    accept_incomplete_allocation = serializers.BooleanField(
+        label=_('Accept Incomplete Allocation'),
+        help_text=_('Allow order to complete with incomplete allocations'),
+        required=False,
+        default=False,
+    )
+
+    def validate_accept_incomplete_allocation(self, value):
+        """Check if the 'accept_incomplete_allocation' field is required."""
+        order = self.context['order']
+
+        if not value and not order.is_fully_allocated():
+            raise ValidationError(_('Order has incomplete allocations'))
+
+        return value
+
+    def get_context_data(self):
+        """Custom context information for this serializer."""
+        order = self.context['order']
+
+        return {'is_complete': order.is_completed()}
+
+    def validate(self, data):
+        """Custom validation for the serializer."""
+        data = super().validate(data)
+        self.order.can_complete(
+            raise_error=True,
+            allow_incomplete_lines=str2bool(
+                data.get('accept_incomplete_allocation', False)
+            ),
+        )
+        return data
+
+    def save(self):
+        """Save the serializer to 'complete' the order."""
+        request = self.context.get('request')
+        data = self.validated_data
+        user = request.user if request else None
+
+        self.order.complete_order(
+            user=user,
+            allow_incomplete_lines=data.get('accept_incomplete_allocation', False),
+        )
+
+
+@register_importer()
+class TransferOrderLineItemSerializer(
+    DataImportExportSerializerMixin,
+    AbstractLineItemSerializer,
+    InvenTreeModelSerializer,
+):
+    """Serializer for a TransferOrderLineItem object."""
+
+    class Meta:
+        """Metaclass options."""
+
+        model = order.models.TransferOrderLineItem
+        fields = AbstractLineItemSerializer.line_fields([
+            'allocated',
+            'overdue',
+            'part',
+            'part_detail',
+            'transferred',
+            # Annotated fields for part stocking information
+            'available_stock',
+            'available_variant_stock',
+            'building',
+            'on_order',
+            # Filterable detail fields
+        ])
+
+    @staticmethod
+    def annotate_queryset(queryset):
+        """Add some extra annotations to this queryset.
+
+        - "overdue" status (boolean field)
+        - "available_quantity"
+        - "building"
+        - "on_order"
+        """
+        queryset = queryset.annotate(
+            overdue=Case(
+                When(
+                    Q(order__status__in=TransferOrderStatusGroups.OPEN)
+                    & order.models.TransferOrderLineItem.OVERDUE_FILTER,
+                    then=Value(True, output_field=BooleanField()),
+                ),
+                default=Value(False, output_field=BooleanField()),
+            )
+        )
+
+        # Annotate each line with the available stock quantity
+        # To do this, we need to look at the total stock and any allocations
+        queryset = queryset.alias(
+            total_stock=part_filters.annotate_total_stock(reference='part__'),
+            allocated_to_sales_orders=part_filters.annotate_sales_order_allocations(
+                reference='part__'
+            ),
+            allocated_to_build_orders=part_filters.annotate_build_order_allocations(
+                reference='part__'
+            ),
+        )
+
+        queryset = queryset.annotate(
+            available_stock=Greatest(
+                ExpressionWrapper(
+                    F('total_stock')
+                    - F('allocated_to_sales_orders')
+                    - F('allocated_to_build_orders'),
+                    output_field=models.DecimalField(),
+                ),
+                0,
+                output_field=models.DecimalField(),
+            )
+        )
+
+        # Add information about the quantity of parts currently on order
+        queryset = queryset.annotate(
+            on_order=part_filters.annotate_on_order_quantity(reference='part__')
+        )
+
+        # Add information about the quantity of parts currently in production
+        queryset = queryset.annotate(
+            building=part_filters.annotate_in_production_quantity(reference='part__')
+        )
+
+        # Annotate total 'allocated' stock quantity
+        queryset = queryset.annotate(
+            allocated=Coalesce(
+                SubquerySum('allocations__quantity'),
+                Decimal(0),
+                output_field=models.DecimalField(),
+            )
+        )
+
+        return queryset
+
+    order_detail = OptionalField(
+        serializer_class=TransferOrderSerializer,
+        serializer_kwargs={
+            'source': 'order',
+            'many': False,
+            'read_only': True,
+            'allow_null': True,
+        },
+        prefetch_fields=[
+            'order__created_by',
+            'order__responsible',
+            'order__project_code',
+        ],
+    )
+
+    part_detail = OptionalField(
+        serializer_class=PartBriefSerializer,
+        serializer_kwargs={
+            'source': 'part',
+            'many': False,
+            'read_only': True,
+            'allow_null': True,
+        },
+        prefetch_fields=['part__pricing_data'],
+    )
+
+    # Annotated fields
+    overdue = serializers.BooleanField(read_only=True, allow_null=True)
+    available_stock = serializers.FloatField(read_only=True)
+    available_variant_stock = serializers.FloatField(read_only=True)
+    on_order = serializers.FloatField(label=_('On Order'), read_only=True)
+    building = serializers.FloatField(label=_('In Production'), read_only=True)
+
+    quantity = InvenTreeDecimalField()
+
+    allocated = serializers.FloatField(read_only=True)
+
+    transferred = InvenTreeDecimalField(read_only=True)
+
+
+class TransferOrderAllocationItemSerializer(serializers.Serializer):
+    """A serializer for allocating a single stock-item against a TransferOrder line item."""
+
+    class Meta:
+        """Metaclass options."""
+
+        fields = ['line_item', 'stock_item', 'quantity']
+
+    line_item = serializers.PrimaryKeyRelatedField(
+        queryset=order.models.TransferOrderLineItem.objects.all(),
+        many=False,
+        allow_null=False,
+        required=True,
+        label=_('Stock Item'),
+    )
+
+    def validate_line_item(self, line_item):
+        """Custom validation for the 'line_item' field.
+
+        - Ensure the line_item is associated with the particular TransferOrder
+        """
+        order = self.context['order']
+
+        # Ensure that the line item points to the correct order
+        if line_item.order != order:
+            raise ValidationError(_('Line item is not associated with this order'))
+
+        return line_item
+
+    stock_item = serializers.PrimaryKeyRelatedField(
+        queryset=stock.models.StockItem.objects.all(),
+        many=False,
+        allow_null=False,
+        required=True,
+        label=_('Stock Item'),
+    )
+
+    quantity = serializers.DecimalField(
+        max_digits=15, decimal_places=5, min_value=Decimal(0), required=True
+    )
+
+    def validate_quantity(self, quantity):
+        """Custom validation for the 'quantity' field."""
+        if quantity <= 0:
+            raise ValidationError(_('Quantity must be positive'))
+
+        return quantity
+
+    def validate(self, data):
+        """Custom validation for the serializer.
+
+        - Ensure that the quantity is 1 for serialized stock
+        - Quantity cannot exceed the available amount
+        """
+        data = super().validate(data)
+
+        stock_item = data['stock_item']
+        quantity = data['quantity']
+
+        if stock_item.serialized and quantity != 1:
+            raise ValidationError({
+                'quantity': _('Quantity must be 1 for serialized stock item')
+            })
+
+        q = normalize(stock_item.unallocated_quantity())
+
+        if quantity > q:
+            raise ValidationError({'quantity': _(f'Available quantity ({q}) exceeded')})
+
+        return data
+
+
+class TransferOrderLineItemAllocationSerializer(serializers.Serializer):
+    """DRF serializer for allocation of stock items against a transfer order line item."""
+
+    class Meta:
+        """Metaclass options."""
+
+        fields = ['items']
+
+    items = TransferOrderAllocationItemSerializer(many=True)
+
+    def validate(self, data):
+        """Serializer validation."""
+        data = super().validate(data)
+
+        # Extract TransferOrder from serializer context
+        # order = self.context['order']
+
+        items = data.get('items', [])
+
+        if len(items) == 0:
+            raise ValidationError(_('Allocation items must be provided'))
+
+        return data
+
+    def save(self):
+        """Perform the allocation of items against this order."""
+        data = self.validated_data
+
+        items = data['items']
+
+        with transaction.atomic():
+            for entry in items:
+                # Create a new TransferOrderAllocation
+                allocation = order.models.TransferOrderAllocation(
+                    line=entry.get('line_item'),
+                    item=entry.get('stock_item'),
+                    quantity=entry.get('quantity'),
+                )
+
+                allocation.full_clean()
+                allocation.save()
+
+
+class TransferOrderAllocationSerializer(
+    FilterableSerializerMixin, InvenTreeModelSerializer
+):
+    """Serializer for the TransferOrderAllocation model.
+
+    This includes some fields from the related model objects.
+    """
+
+    class Meta:
+        """Metaclass options."""
+
+        model = order.models.TransferOrderAllocation
+        fields = [
+            'pk',
+            'item',
+            'quantity',
+            # Annotated read-only fields
+            'line',
+            'part',
+            'order',
+            'serial',
+            'location',
+            # Extra detail fields
+            'item_detail',
+            'part_detail',
+            'order_detail',
+            'location_detail',
+        ]
+        read_only_fields = ['line', '']
+
+    part = serializers.PrimaryKeyRelatedField(source='item.part', read_only=True)
+    order = serializers.PrimaryKeyRelatedField(
+        source='line.order', many=False, read_only=True
+    )
+    serial = serializers.CharField(source='get_serial', read_only=True, allow_null=True)
+    quantity = serializers.FloatField(read_only=False)
+    location = serializers.PrimaryKeyRelatedField(
+        source='item.location', many=False, read_only=True
+    )
+
+    # Extra detail fields
+    order_detail = OptionalField(
+        serializer_class=TransferOrderSerializer,
+        serializer_kwargs={
+            'source': 'line.order',
+            'many': False,
+            'read_only': True,
+            'allow_null': True,
+        },
+    )
+
+    part_detail = OptionalField(
+        serializer_class=PartBriefSerializer,
+        serializer_kwargs={
+            'source': 'item.part',
+            'many': False,
+            'read_only': True,
+            'allow_null': True,
+        },
+    )
+
+    item_detail = OptionalField(
+        serializer_class=stock.serializers.StockItemSerializer,
+        serializer_kwargs={
+            'source': 'item',
+            'many': False,
+            'read_only': True,
+            'allow_null': True,
+            'part_detail': False,
+            'location_detail': False,
+            'supplier_part_detail': False,
+        },
+    )
+
+    location_detail = OptionalField(
+        serializer_class=stock.serializers.LocationBriefSerializer,
+        serializer_kwargs={
+            'source': 'item.location',
+            'many': False,
+            'read_only': True,
+            'allow_null': True,
+        },
+    )
+
+
+class TransferOrderSerialAllocationSerializer(serializers.Serializer):
+    """DRF serializer for allocation of serial numbers against a transfer order."""
+
+    class Meta:
+        """Metaclass options."""
+
+        fields = ['line_item', 'quantity', 'serial_numbers']
+
+    line_item = serializers.PrimaryKeyRelatedField(
+        queryset=order.models.TransferOrderLineItem.objects.all(),
+        many=False,
+        required=True,
+        allow_null=False,
+        label=_('Line Item'),
+    )
+
+    def validate_line_item(self, line_item):
+        """Ensure that the line_item is valid."""
+        order = self.context['order']
+
+        # Ensure that the line item points to the correct order
+        if line_item.order != order:
+            raise ValidationError(_('Line item is not associated with this order'))
+
+        return line_item
+
+    quantity = serializers.IntegerField(
+        min_value=1, required=True, allow_null=False, label=_('Quantity')
+    )
+
+    serial_numbers = serializers.CharField(
+        label=_('Serial Numbers'),
+        help_text=_('Enter serial numbers to allocate'),
+        required=True,
+        allow_blank=False,
+    )
+
+    def validate(self, data):
+        """Validation for the serializer.
+
+        - Ensure the serial_numbers and quantity fields match
+        - Check that all serial numbers exist
+        - Check that the serial numbers are not yet allocated
+        """
+        data = super().validate(data)
+
+        line_item = data['line_item']
+        quantity = data['quantity']
+        serial_numbers = data['serial_numbers']
+
+        part = line_item.part
+
+        try:
+            data['serials'] = extract_serial_numbers(
+                serial_numbers, quantity, part.get_latest_serial_number(), part=part
+            )
+        except DjangoValidationError as e:
+            raise ValidationError({'serial_numbers': e.messages})
+
+        serials_not_exist = set()
+        serials_unavailable = set()
+        stock_items_to_allocate = []
+
+        for serial in data['serials']:
+            serial = str(serial).strip()
+
+            items = stock.models.StockItem.objects.filter(
+                part=part, serial=serial, quantity=1
+            )
+
+            if not items.exists():
+                serials_not_exist.add(str(serial))
+                continue
+
+            stock_item = items[0]
+
+            if not stock_item.in_stock:
+                serials_unavailable.add(str(serial))
+                continue
+
+            if stock_item.unallocated_quantity() < 1:
+                serials_unavailable.add(str(serial))
+                continue
+
+            # At this point, the serial number is valid, and can be added to the list
+            stock_items_to_allocate.append(stock_item)
+
+        if len(serials_not_exist) > 0:
+            error_msg = _('No match found for the following serial numbers')
+            error_msg += ': '
+            error_msg += ','.join(sorted(serials_not_exist))
+
+            raise ValidationError({'serial_numbers': error_msg})
+
+        if len(serials_unavailable) > 0:
+            error_msg = _('The following serial numbers are unavailable')
+            error_msg += ': '
+            error_msg += ','.join(sorted(serials_unavailable))
+
+            raise ValidationError({'serial_numbers': error_msg})
+
+        data['stock_items'] = stock_items_to_allocate
+
+        return data
+
+    def save(self):
+        """Allocate stock items against the transfer order."""
+        data = self.validated_data
+
+        line_item = data['line_item']
+        stock_items = data['stock_items']
+
+        allocations = []
+
+        for stock_item in stock_items:
+            # Create a new TransferOrderAllocation
+            allocations.append(
+                order.models.TransferOrderAllocation(
+                    line=line_item, item=stock_item, quantity=1
+                )
+            )
+
+        with transaction.atomic():
+            order.models.TransferOrderAllocation.objects.bulk_create(allocations)
diff --git a/src/backend/InvenTree/order/status_codes.py b/src/backend/InvenTree/order/status_codes.py
index 7ec5756b92..d8893a1fa3 100644
--- a/src/backend/InvenTree/order/status_codes.py
+++ b/src/backend/InvenTree/order/status_codes.py
@@ -115,3 +115,30 @@ class ReturnOrderLineStatus(StatusCode):
 
     # Item is rejected
     REJECT = 60, _('Reject'), ColorEnum.danger
+
+
+class TransferOrderStatus(StatusCode):
+    """Defines a set of status codes for a TransferOrder."""
+
+    # Order status codes
+    PENDING = 10, _('Pending'), ColorEnum.secondary  # Order is pending (not yet issued)
+    ISSUED = 20, _('Issued'), ColorEnum.primary  # Order has been issued
+    ON_HOLD = 25, _('On Hold'), ColorEnum.warning  # Order is on hold
+    COMPLETE = 30, _('Complete'), ColorEnum.success  # Order has been completed
+    CANCELLED = 40, _('Cancelled'), ColorEnum.danger  # Order was cancelled
+
+
+class TransferOrderStatusGroups:
+    """Groups for TransferOrderStatus codes."""
+
+    # Open orders
+    OPEN = [
+        TransferOrderStatus.PENDING.value,
+        TransferOrderStatus.ON_HOLD.value,
+        TransferOrderStatus.ISSUED.value,
+    ]
+
+    # Failed orders
+    FAILED = [TransferOrderStatus.CANCELLED.value]
+
+    COMPLETE = [TransferOrderStatus.COMPLETE.value]
diff --git a/src/backend/InvenTree/order/test_api.py b/src/backend/InvenTree/order/test_api.py
index fae21e6e37..2da8cd6115 100644
--- a/src/backend/InvenTree/order/test_api.py
+++ b/src/backend/InvenTree/order/test_api.py
@@ -27,6 +27,8 @@ from order.status_codes import (
     ReturnOrderStatus,
     SalesOrderStatus,
     SalesOrderStatusGroups,
+    TransferOrderStatus,
+    TransferOrderStatusGroups,
 )
 from part.models import Part
 from stock.models import StockItem, StockLocation
@@ -46,9 +48,10 @@ class OrderTest(InvenTreeAPITestCase):
         'stock',
         'order',
         'sales_order',
+        'transfer_order',
     ]
 
-    roles = ['purchase_order.change', 'sales_order.change']
+    roles = ['purchase_order.change', 'sales_order.change', 'transfer_order.change']
 
     def filter(self, filters, count):
         """Test API filters."""
@@ -2892,3 +2895,848 @@ class ReturnOrderLineItemTests(InvenTreeAPITestCase):
 
         line = models.ReturnOrderLineItem.objects.get(pk=1)
         self.assertEqual(float(line.price.amount), 15.75)
+
+
+class TransferOrderTest(OrderTest):
+    """Tests for the TransferOrder API."""
+
+    LIST_URL = reverse('api-transfer-order-list')
+
+    def test_transfer_order_list(self):
+        """Test the TransferOrder list API endpoint."""
+        # all orders
+        self.filter({}, 5)
+
+        # filter by outstanding
+        self.filter({'outstanding': True}, 3)
+        self.filter({'outstanding': False}, 2)
+
+        # Filter by status
+        self.filter({'status': TransferOrderStatus.PENDING.value}, 1)
+        self.filter({'status': SalesOrderStatus.COMPLETE.value}, 1)
+        self.filter({'status': 99}, 0)  # Invalid
+
+        # Filter by "reference"
+        self.filter({'reference': 'TO-123'}, 1)
+        self.filter({'reference': 'TO-999'}, 0)
+
+        # Filter by "assigned_to_me"
+        self.filter({'assigned_to_me': 1}, 0)
+        self.filter({'assigned_to_me': 0}, 5)
+
+    def test_overdue(self):
+        """Test "overdue" status."""
+        self.filter({'overdue': True}, 0)
+        self.filter({'overdue': False}, 5)
+
+        # pick two orders that are still open (not cancelled or complete)
+        for pk in [1, 4]:
+            order = models.TransferOrder.objects.get(pk=pk)
+            order.target_date = datetime.now().date() - timedelta(days=10)
+            order.save()
+
+        self.filter({'overdue': True}, 2)
+        self.filter({'overdue': False}, 3)
+
+    def test_transfer_order_detail(self):
+        """Test the TransferOrder detail endpoint."""
+        url = '/api/order/transfer-order/1/'
+
+        response = self.get(url)
+
+        data = response.data
+
+        self.assertEqual(data['pk'], 1)
+
+    def test_transfer_order_attachments(self):
+        """Test the list endpoint for the Transfer Order Attachments."""
+        url = reverse('api-attachment-list')
+
+        # Filter by 'transferorder'
+        self.get(
+            url, data={'model_type': 'transferorder', 'model_id': 1}, expected_code=200
+        )
+
+    def test_transfer_order_operations(self):
+        """Test that we can create / edit and delete a TransferOrder via the API."""
+        n = models.TransferOrder.objects.count()
+
+        url = reverse('api-transfer-order-list')
+
+        # Initially we do not have "add" permission for the TransferOrder model,
+        # so this POST request should return 403 (denied)
+        response = self.post(
+            url,
+            {'reference': 'TO-43245', 'description': 'Transfer order'},
+            expected_code=403,
+        )
+
+        self.assignRole('transfer_order.add')
+
+        # Now we should be able to create a TransferOrder via the API
+        response = self.post(
+            url,
+            {'reference': 'TO-12345', 'description': 'Transfer order'},
+            expected_code=201,
+        )
+
+        # Check that the new order has been created
+        self.assertEqual(models.TransferOrder.objects.count(), n + 1)
+
+        # Grab the PK for the newly created TransferOrder
+        pk = response.data['pk']
+
+        # Basic checks against the newly created TransferOrder
+        so = models.TransferOrder.objects.get(pk=pk)
+        self.assertEqual(so.reference, 'TO-12345')
+        self.assertEqual(so.created_by.username, 'testuser')
+
+        # Try to create a TO with identical reference (should fail)
+        response = self.post(
+            url,
+            {
+                'customer': 4,
+                'reference': 'TO-12345',
+                'description': 'Another transfer order',
+            },
+            expected_code=400,
+        )
+
+        url = reverse('api-transfer-order-detail', kwargs={'pk': pk})
+
+        # Extract detail info for the TransferOrder
+        response = self.get(url)
+        self.assertEqual(response.data['reference'], 'TO-12345')
+
+        # Try to alter (edit) the TransferOrder
+        # Initially try with an invalid reference field value
+        response = self.patch(url, {'reference': 'TO-12345-a'}, expected_code=400)
+
+        response = self.patch(url, {'reference': 'TO-12346'}, expected_code=200)
+
+        # Reference should have changed
+        self.assertEqual(response.data['reference'], 'TO-12346')
+
+        # Now, let's try to delete this TransferOrder
+        # Initially, we do not have the required permission
+        response = self.delete(url, expected_code=403)
+
+        self.assignRole('transfer_order.delete')
+
+        response = self.delete(url, expected_code=204)
+
+        # Check that the number of transfer orders has decreased
+        self.assertEqual(models.TransferOrder.objects.count(), n)
+
+        # And the resource should no longer be available
+        response = self.get(url, expected_code=404)
+
+    def test_transfer_order_create(self):
+        """Test that we can create a new TransferOrder via the API."""
+        self.assignRole('transfer_order.add')
+
+        url = reverse('api-transfer-order-list')
+
+        # Will fail due to invalid reference field
+        response = self.post(
+            url,
+            {'reference': '1234566778', 'description': 'A test transfer order'},
+            expected_code=400,
+        )
+
+        self.assertIn(
+            'Reference must match required pattern', str(response.data['reference'])
+        )
+
+        self.post(
+            url,
+            {'reference': 'TO-12345', 'description': 'A better test transfer order'},
+            expected_code=201,
+        )
+
+    def test_transfer_order_cancel(self):
+        """Test API endpoint for cancelling a TransferOrder."""
+        to = models.TransferOrder.objects.get(pk=1)
+
+        self.assertEqual(to.status, TransferOrderStatus.PENDING)
+
+        url = reverse('api-transfer-order-cancel', kwargs={'pk': to.pk})
+
+        # Try to cancel, without permission
+        self.post(url, {}, expected_code=403)
+
+        self.assignRole('transfer_order.add')
+
+        self.post(url, {}, expected_code=201)
+
+        to.refresh_from_db()
+
+        self.assertEqual(to.status, TransferOrderStatus.CANCELLED)
+
+    def test_transfer_order_hold(self):
+        """Test API endpoint for holdling a TransferOrder."""
+        to = models.TransferOrder.objects.get(pk=1)
+
+        self.assertEqual(to.status, TransferOrderStatus.PENDING)
+
+        url = reverse('api-transfer-order-hold', kwargs={'pk': to.pk})
+
+        # Try to hold, without permission
+        self.post(url, {}, expected_code=403)
+
+        self.assignRole('transfer_order.add')
+
+        self.post(url, {}, expected_code=201)
+
+        to.refresh_from_db()
+
+        self.assertEqual(to.status, TransferOrderStatus.ON_HOLD)
+
+    def test_transfer_order_calendar(self):
+        """Test the calendar export endpoint."""
+        # Create required transfer orders
+        self.assignRole('transfer_order.add')
+
+        for i in range(1, 9):
+            self.post(
+                reverse('api-transfer-order-list'),
+                {
+                    'reference': f'TO-1100000{i}',
+                    'description': f'Calendar SO {i}',
+                    'target_date': f'2024-12-{i:02d}',
+                },
+                expected_code=201,
+            )
+
+        # Cancel a few orders - these will not show in incomplete view below
+        for to in models.TransferOrder.objects.filter(target_date__isnull=False):
+            if to.reference in [
+                'TO-11000006',
+                'TO-11000007',
+                'TO-11000008',
+                'TO-11000009',
+            ]:
+                self.post(
+                    reverse('api-transfer-order-cancel', kwargs={'pk': to.pk}),
+                    expected_code=201,
+                )
+
+        url = reverse('api-po-so-calendar', kwargs={'ordertype': 'transfer-order'})
+
+        # Test without completed orders
+        response = self.get(url, expected_code=200, format=None)
+
+        number_orders = len(
+            models.TransferOrder.objects.filter(target_date__isnull=False).filter(
+                status__lt=TransferOrderStatus.COMPLETE.value
+            )
+        )
+
+        # Transform content to a Calendar object
+        calendar = Calendar.from_ical(response.content)
+        n_events = 0
+        # Count number of events in calendar
+        for component in calendar.walk():
+            if component.name == 'VEVENT':
+                n_events += 1
+
+        self.assertGreaterEqual(n_events, 1)
+        self.assertEqual(number_orders, n_events)
+
+        # Test with completed orders
+        response = self.get(
+            url, data={'include_completed': 'True'}, expected_code=200, format=None
+        )
+
+        number_orders_incl_complete = len(
+            models.TransferOrder.objects.filter(target_date__isnull=False)
+        )
+        self.assertGreater(number_orders_incl_complete, number_orders)
+
+        # Transform content to a Calendar object
+        calendar = Calendar.from_ical(response.content)
+        n_events = 0
+        # Count number of events in calendar
+        for component in calendar.walk():
+            if component.name == 'VEVENT':
+                n_events += 1
+
+        self.assertGreaterEqual(n_events, 1)
+        self.assertEqual(number_orders_incl_complete, n_events)
+
+    def test_export(self):
+        """Test we can export the TransferOrder list."""
+        n = models.TransferOrder.objects.count()
+
+        # Check there are some sales orders
+        self.assertGreater(n, 0)
+
+        # Download file, check we get a 200 response
+        for fmt in ['csv', 'xlsx', 'tsv']:
+            self.export_data(
+                reverse('api-transfer-order-list'),
+                export_format=fmt,
+                decode=fmt == 'csv',
+                expected_code=200,
+                expected_fn=r'InvenTree_TransferOrder_.+',
+            )
+
+    def test_transfer_order_complete(self):
+        """Tests for marking a TransferOrder as complete."""
+        self.assignRole('transfer_order.add')
+        destination = StockLocation.objects.first()
+        # Let's create a TransferOrder
+        to = models.TransferOrder.objects.create(
+            reference='TO-12345', description='Test TO'
+        )
+
+        self.assertEqual(to.status, TransferOrderStatus.PENDING.value)
+
+        # Create a line item
+        part = Part.objects.exclude(virtual=True).first()
+
+        line = models.TransferOrderLineItem.objects.create(
+            order=to, part=part, quantity=10
+        )
+
+        # issue the order
+        url = reverse('api-transfer-order-issue', kwargs={'pk': to.pk})
+        self.post(url, {}, expected_code=201)
+        to.refresh_from_db()
+        self.assertEqual(to.status, TransferOrderStatus.ISSUED.value)
+
+        # Allocate some stock
+        item = StockItem.objects.create(
+            part=part, quantity=100, location=None, batch='transfer-order-test'
+        )
+        short_allocation = models.TransferOrderAllocation.objects.create(
+            quantity=5, line=line, item=item
+        )
+
+        # attempt to complete the order, but fail because there are incomplete allocations
+        url = reverse('api-transfer-order-complete', kwargs={'pk': to.pk})
+        response = self.post(url, {}, expected_code=400)
+        self.assertIn('has incomplete allocations', str(response.data))
+        # allocate more stock
+        short_allocation.delete()
+        models.TransferOrderAllocation.objects.create(quantity=10, line=line, item=item)
+
+        # attempt to complete the order, but fail because there is no destination yet
+        url = reverse('api-transfer-order-complete', kwargs={'pk': to.pk})
+        response = self.post(url, {}, expected_code=400)
+        self.assertIn('until a destination location is set', str(response.data))
+        # add destination
+        to.destination = destination
+        to.save()
+
+        # Ok, now we should be able to "complete" the transfer via the API
+        url = reverse('api-transfer-order-complete', kwargs={'pk': to.pk})
+        self.post(url, {}, expected_code=201)
+
+        to.refresh_from_db()
+        self.assertEqual(to.status, TransferOrderStatus.COMPLETE.value)
+        self.assertIsNotNone(to.complete_date)
+
+        # Now, let's try *again* (it should fail as the order is already complete)
+        response = self.post(url, {}, expected_code=400)
+        self.assertIn('Order is already complete', str(response.data))
+
+        # Now, we make sure the affected stock was transferred to the correct location
+        StockItem.objects.get(
+            part=part, quantity=10, batch='transfer-order-test', location=destination
+        )
+
+    def test_transfer_order_consume(self):
+        """Tests for marking a TransferOrder consume the stock it 'transfers'."""
+        self.assignRole('transfer_order.add')
+        destination = StockLocation.objects.first()
+        # Let's create a TransferOrder
+        to = models.TransferOrder.objects.create(
+            reference='TO-12345',
+            description='Test TO',
+            consume=True,
+            destination=destination,
+        )
+
+        self.assertEqual(to.status, TransferOrderStatus.PENDING.value)
+
+        # Create a line item
+        part = Part.objects.exclude(virtual=True).first()
+
+        line = models.TransferOrderLineItem.objects.create(
+            order=to, part=part, quantity=10
+        )
+
+        # issue the order
+        url = reverse('api-transfer-order-issue', kwargs={'pk': to.pk})
+        self.post(url, {}, expected_code=201)
+        to.refresh_from_db()
+        self.assertEqual(to.status, TransferOrderStatus.ISSUED.value)
+
+        # Allocate some stock
+        item = StockItem.objects.create(
+            part=part, quantity=100, location=None, batch='transfer-order-test'
+        )
+        models.TransferOrderAllocation.objects.create(quantity=10, line=line, item=item)
+
+        # Ok, now we should be able to "complete" the transfer via the API
+        url = reverse('api-transfer-order-complete', kwargs={'pk': to.pk})
+        self.post(url, {}, expected_code=201)
+
+        to.refresh_from_db()
+        self.assertEqual(to.status, TransferOrderStatus.COMPLETE.value)
+        self.assertIsNotNone(to.complete_date)
+
+        # Now, we make sure the affected stock was 'consumed', reducing available quantity
+        item.refresh_from_db()
+        self.assertEqual(item.quantity, 90)
+
+        # and that it wasn't transferred to the destination
+        with self.assertRaises(StockItem.DoesNotExist):
+            StockItem.objects.get(
+                part=part,
+                quantity=10,
+                batch='transfer-order-test',
+                location=destination,
+            )
+
+    def test_output_options(self):
+        """Test the output options for the TransferOrder detail endpoint."""
+        self.run_output_test(
+            reverse('api-transfer-order-detail', kwargs={'pk': 1}),
+            ['take_from_detail', 'destination_detail'],
+        )
+
+
+class TransferOrderLineItemTest(OrderTest):
+    """Tests for the TransferOrderLineItem API."""
+
+    LIST_URL = reverse('api-transfer-order-line-list')
+
+    # adjust counts in asserts based on those created in setUpTestData
+    # plus those in fixtures
+    NUM_LINE_ITEMS_IN_FIXTURES = 2
+
+    @classmethod
+    def setUpTestData(cls):
+        """Init routine for this unit test class."""
+        super().setUpTestData()
+
+        # List of 'transferrable' parts
+        parts = Part.objects.exclude(virtual=True)
+
+        lines = []
+
+        # Create a bunch of TransferOrderLineItems for each order
+        for idx, to in enumerate(models.TransferOrder.objects.all()):
+            for part in parts:
+                lines.append(
+                    models.TransferOrderLineItem(
+                        order=to,
+                        part=part,
+                        quantity=(idx + 1) * 5,
+                        reference=f'Order {to.reference} - line {idx}',
+                    )
+                )
+
+        # Bulk create
+        models.TransferOrderLineItem.objects.bulk_create(lines)
+
+        cls.url = reverse('api-transfer-order-line-list')
+
+    def test_transfer_order_line_list(self):
+        """Test list endpoint."""
+        response = self.get(self.url, {}, expected_code=200)
+
+        n = models.TransferOrderLineItem.objects.count()
+
+        # We should have received *all* lines
+        self.assertEqual(len(response.data), n)
+
+        # List *all* lines, but paginate
+        response = self.get(self.url, {'limit': 5}, expected_code=200)
+
+        self.assertEqual(response.data['count'], n)
+        self.assertEqual(len(response.data['results']), 5)
+
+        n_orders = models.TransferOrder.objects.count()
+        n_parts = Part.objects.exclude(virtual=True).count()
+
+        # List by part
+        # fixures add line items, avoid those here with [:3] for predictable counts
+        for part in Part.objects.exclude(virtual=True)[:3]:
+            response = self.get(self.url, {'part': part.pk, 'limit': 10})
+            self.assertEqual(response.data['count'], n_orders)
+
+        # List by order
+        # fixures add line items, avoid those here with [:3] for predictable counts
+        for order in models.TransferOrder.objects.all()[:3]:
+            response = self.get(self.url, {'order': order.pk, 'limit': 10})
+            # count of line items equal to number of parts because
+            # we created a line item per part on each order in setUpTestData
+            self.assertEqual(response.data['count'], n_parts)
+
+        # Filter by 'completed' status
+        self.filter({'completed': 1}, 1)
+        self.filter({'completed': 0}, n - 1)
+
+        # Filter by 'allocated' status
+        self.filter({'allocated': 'true'}, 2)
+        self.filter({'allocated': 'false'}, n - 2)
+
+    def test_transfer_order_line_allocated_filters(self):
+        """Test filtering by allocation status for a TransferOrderLineItem."""
+        self.assignRole('transfer_order.add')
+
+        destination = StockLocation.objects.first()
+        assert destination
+
+        response = self.post(
+            reverse('api-transfer-order-list'),
+            {
+                'reference': 'TO-12345',
+                'description': 'Test Transfer Order',
+                'destination': destination.pk,
+            },
+        )
+
+        order_id = response.data['pk']
+        order = models.TransferOrder.objects.get(pk=order_id)
+
+        transfer_order_line_url = reverse('api-transfer-order-line-list')
+
+        # Initially, there should be no line items against this order
+        response = self.get(transfer_order_line_url, {'order': order_id})
+
+        self.assertEqual(len(response.data), 0)
+
+        parts = [25, 50, 100]
+
+        # Let's create some new line items
+        for part_id in parts:
+            self.post(
+                transfer_order_line_url,
+                {'order': order_id, 'part': part_id, 'quantity': 10},
+            )
+
+        # Should be three items now
+        response = self.get(transfer_order_line_url, {'order': order_id})
+
+        self.assertEqual(len(response.data), 3)
+
+        for item in response.data:
+            # Check that the line item has been created
+            self.assertEqual(item['order'], order_id)
+
+            # Check that the line quantities are correct
+            self.assertEqual(item['quantity'], 10)
+            self.assertEqual(item['allocated'], 0)
+            self.assertEqual(item['transferred'], 0)
+
+        # Initial API filters should return no results
+        self.filter({'order': order_id, 'allocated': 1}, 0)
+        self.filter({'order': order_id, 'completed': 1}, 0)
+
+        # issue the order
+        order_issue_url = reverse('api-transfer-order-issue', kwargs={'pk': order.pk})
+        self.post(order_issue_url, {}, expected_code=201)
+
+        # Next, allocate stock against 2 line items
+        for item in parts[:2]:
+            p = Part.objects.get(pk=item)
+            s = StockItem.objects.create(part=p, quantity=100)
+            l = models.TransferOrderLineItem.objects.filter(order=order, part=p).first()
+            assert l
+
+            # Allocate against the API
+            self.post(
+                reverse('api-transfer-order-allocate', kwargs={'pk': order.pk}),
+                {'items': [{'line_item': l.pk, 'stock_item': s.pk, 'quantity': 10}]},
+            )
+
+        # Filter by 'fully allocated' status
+        self.filter({'order': order_id, 'allocated': 1}, 2)
+        self.filter({'order': order_id, 'allocated': 0}, 1)
+
+        self.filter({'order': order_id, 'completed': 1}, 0)
+        self.filter({'order': order_id, 'completed': 0}, 3)
+
+        # Finally, attempt to transfer this line item
+        # we have incomplete allocations, so must specify arg
+        self.post(
+            reverse('api-transfer-order-complete', kwargs={'pk': order.pk}),
+            {'accept_incomplete_allocation': 'true'},
+        )
+
+        # Filter by 'completed' status
+        self.filter({'order': order_id, 'completed': 1}, 2)
+        self.filter({'order': order_id, 'completed': 0}, 1)
+
+    def test_output_options(self):
+        """Test the various output options for the TransferOrderLineItem detail endpoint."""
+        self.run_output_test(
+            reverse('api-transfer-order-line-detail', kwargs={'pk': 1}),
+            ['part_detail', 'order_detail'],
+        )
+
+
+class TransferOrderDownloadTest(OrderTest):
+    """Unit tests for downloading TransferOrder data via the API endpoint."""
+
+    def test_download_fail(self):
+        """Test that downloading without the 'export' option fails."""
+        url = reverse('api-transfer-order-list')
+
+        response = self.export_data(url, export_plugin='no-plugin', expected_code=400)
+        self.assertIn('is not a valid choice', str(response['export_plugin']))
+
+    def test_download_xlsx(self):
+        """Test xlsx file download."""
+        url = reverse('api-transfer-order-list')
+
+        # Download .xls file
+        with self.export_data(
+            url, export_format='xlsx', expected_code=200, decode=False
+        ) as file:
+            self.assertIsInstance(file, io.BytesIO)
+
+    def test_download_csv(self):
+        """Test that the list of transfer orders can be downloaded as a .csv file."""
+        url = reverse('api-transfer-order-list')
+
+        required_cols = [
+            'Line Items',
+            'Completed Lines',
+            'ID',
+            'Reference',
+            'Order Status',
+            'Description',
+            'Project Code',
+            'Responsible',
+            'Consume Stock',
+        ]
+
+        excluded_cols = ['metadata']
+
+        # Download .xls file
+        with self.export_data(url, export_format='csv') as file:
+            data = self.process_csv(
+                file,
+                required_cols=required_cols,
+                excluded_cols=excluded_cols,
+                required_rows=models.TransferOrder.objects.count(),
+            )
+
+            for line in data:
+                order = models.TransferOrder.objects.get(pk=line['ID'])
+
+                self.assertEqual(line['Description'], order.description)
+                self.assertEqual(line['Order Status'], str(order.status))
+
+        # Download only outstanding transfer orders
+        with self.export_data(url, {'outstanding': True}, export_format='tsv') as file:
+            self.process_csv(
+                file,
+                required_cols=required_cols,
+                excluded_cols=excluded_cols,
+                required_rows=models.TransferOrder.objects.filter(
+                    status__in=TransferOrderStatusGroups.OPEN
+                ).count(),
+                delimiter='\t',
+            )
+
+
+class TransferOrderAllocateTest(OrderTest):
+    """Unit tests for allocating stock items against a TransferOrder."""
+
+    @classmethod
+    def setUpTestData(cls):
+        """Init routine for this unit test class."""
+        super().setUpTestData()
+
+    def setUp(self):
+        """Init routines for this unit testing class."""
+        super().setUp()
+
+        self.assignRole('transfer_order.add')
+
+        self.url = reverse('api-transfer-order-allocate', kwargs={'pk': 1})
+        self.url_serialized = reverse(
+            'api-transfer-order-allocate-serials', kwargs={'pk': 1}
+        )
+
+        self.order = models.TransferOrder.objects.get(pk=1)
+
+        # Create some line items for this transfer order
+        parts = Part.objects.exclude(virtual=True)
+
+        for part in parts:
+            # Create a new line item
+            models.TransferOrderLineItem.objects.create(
+                order=self.order, part=part, quantity=5
+            )
+
+            # Ensure we have stock!
+            StockItem.objects.create(part=part, quantity=100)
+
+        # Create a new shipment against this TransferOrder
+        # self.shipment = models.TransferOrderShipment.objects.create(order=self.order)
+
+    def test_invalid(self):
+        """Test POST with invalid data."""
+        # No data
+        response = self.post(self.url, {}, expected_code=400)
+
+        self.assertIn('This field is required', str(response.data['items']))
+
+        # Test with a single line items
+        line = self.order.lines.first()
+        part = line.part
+
+        # Valid stock_item, but quantity is invalid
+        data = {
+            'items': [
+                {
+                    'line_item': line.pk,
+                    'stock_item': part.stock_items.last().pk,
+                    'quantity': 0,
+                }
+            ]
+        }
+
+        response = self.post(self.url, data, expected_code=400)
+
+        self.assertIn('Quantity must be positive', str(response.data['items']))
+
+        # Valid stock item, too much quantity
+        data['items'][0]['quantity'] = 250
+
+        response = self.post(self.url, data, expected_code=400)
+
+        self.assertIn('Available quantity (100) exceeded', str(response.data['items']))
+
+    def test_allocate(self):
+        """Test that the allocation endpoint acts as expected, when provided with valid data!"""
+        # First, check that there are no line items allocated against this TransferOrder
+        self.assertEqual(self.order.stock_allocations.count(), 0)
+
+        data = {'items': []}
+
+        for line in self.order.lines.all():
+            for stock_item in line.part.stock_items.filter(quantity__gt=5):
+                # Find a non-serialized stock item to allocate
+                if not stock_item.serialized:
+                    break
+
+            # Fully-allocate each line
+            data['items'].append({
+                'line_item': line.pk,
+                'stock_item': stock_item.pk,
+                'quantity': 5,
+            })
+
+        self.post(self.url, data, expected_code=201)
+
+        # There should have been 1 stock item allocated against each line item
+        n_lines = self.order.lines.count()
+
+        self.assertEqual(self.order.stock_allocations.count(), n_lines)
+
+        for line in self.order.lines.all():
+            self.assertEqual(line.allocations.count(), 1)
+
+    def test_allocate_serials(self):
+        """Test that the allocation endpoint acts as expected, when provided with serials."""
+        self.assertEqual(self.order.stock_allocations.count(), 0)
+
+        trackable_lines = self.order.lines.filter(part__trackable=True)
+        for line in trackable_lines:
+            stock_item = (
+                line.part.stock_items
+                .exclude(serial=None)
+                .filter(StockItem.IN_STOCK_FILTER)
+                .first()
+            )
+
+            # Allocate this serialized item to the transfer order
+            data = {
+                'line_item': line.pk,
+                'quantity': 1,
+                'serial_numbers': stock_item.serial,
+            }
+
+            self.post(self.url_serialized, data, expected_code=201)
+
+        # There should have been 1 stock item allocated against each line item
+        n_lines = trackable_lines.count()
+        self.assertEqual(self.order.stock_allocations.count(), n_lines)
+
+        for line in trackable_lines.all():
+            self.assertEqual(line.allocations.count(), 1)
+
+    def test_allocate_variant(self):
+        """Test that the allocation endpoint acts as expected, when provided with variant."""
+        # First, check that there are no line items allocated against this TransferOrder
+        self.assertEqual(self.order.stock_allocations.count(), 0)
+
+        data = {'items': []}
+
+        def check_template(line_item):
+            return line_item.part.is_template
+
+        for line in filter(check_template, self.order.lines.all()):
+            stock_item: Optional[StockItem] = None
+
+            stock_item = None
+
+            # Allocate a matching variant
+            parts: list[Part] = (
+                Part.objects
+                .exclude(virtual=True)
+                .exclude(is_template=True)
+                .filter(variant_of=line.part.pk)
+            )
+            # if we don't have a matching variant, continue
+            if not parts.exists():
+                continue
+            for part in parts:
+                # ensure we have the quantity necessary to allocate
+                if not part.stock_items.filter(quantity__gt=5).exists():
+                    continue
+
+                stock_item = part.stock_items.last()
+
+                for item in part.stock_items.filter(quantity__gt=5):
+                    if item.serialized:
+                        continue
+
+                    stock_item = item
+                    break
+
+                if stock_item is not None:
+                    break
+
+            if stock_item is None:
+                raise self.fail('No stock item found for part')  # pragma: no cover
+
+            # Fully-allocate each line
+            data['items'].append({
+                'line_item': line.pk,
+                'stock_item': stock_item.pk,
+                'quantity': 5,
+            })
+
+        self.post(self.url, data, expected_code=201)
+
+        # At least one item should be allocated, and all should be variants
+        self.assertGreater(self.order.stock_allocations.count(), 0)
+        for allocation in self.order.stock_allocations.all():
+            self.assertNotEqual(allocation.item.part.pk, allocation.line.part.pk)
+
+    def test_output_options(self):
+        """Test the various output options for the SalesOrderAllocation detail endpoint."""
+        self.run_output_test(
+            reverse('api-transfer-order-allocation-list'),
+            ['part_detail', 'item_detail', 'order_detail', 'location_detail'],
+            assert_subset=True,
+        )
diff --git a/src/backend/InvenTree/order/validators.py b/src/backend/InvenTree/order/validators.py
index a4873679bd..ce2004de76 100644
--- a/src/backend/InvenTree/order/validators.py
+++ b/src/backend/InvenTree/order/validators.py
@@ -22,6 +22,13 @@ def generate_next_return_order_reference():
     return ReturnOrder.generate_reference()
 
 
+def generate_next_transfer_order_reference():
+    """Generate the next available TransferOrder reference."""
+    from order.models import TransferOrder
+
+    return TransferOrder.generate_reference()
+
+
 def validate_sales_order_reference_pattern(pattern):
     """Validate the SalesOrder reference 'pattern' setting."""
     from order.models import SalesOrder
@@ -62,3 +69,17 @@ def validate_return_order_reference(value):
     from order.models import ReturnOrder
 
     ReturnOrder.validate_reference_field(value)
+
+
+def validate_transfer_order_reference_pattern(pattern):
+    """Validate the TransferOrder reference 'pattern' setting."""
+    from order.models import TransferOrder
+
+    TransferOrder.validate_reference_pattern(pattern)
+
+
+def validate_transfer_order_reference(value):
+    """Validate that the ReturnOrder reference field matches the required pattern."""
+    from order.models import TransferOrder
+
+    TransferOrder.validate_reference_field(value)
diff --git a/src/backend/InvenTree/part/filters.py b/src/backend/InvenTree/part/filters.py
index d6610260d5..2c832c2e9e 100644
--- a/src/backend/InvenTree/part/filters.py
+++ b/src/backend/InvenTree/part/filters.py
@@ -37,7 +37,11 @@ from sql_util.utils import SubquerySum
 import part.models
 import stock.models
 from build.status_codes import BuildStatusGroups
-from order.status_codes import PurchaseOrderStatusGroups, SalesOrderStatusGroups
+from order.status_codes import (
+    PurchaseOrderStatusGroups,
+    SalesOrderStatusGroups,
+    TransferOrderStatusGroups,
+)
 
 
 def annotate_in_production_quantity(reference: str = '') -> QuerySet:
@@ -274,6 +278,40 @@ def annotate_sales_order_allocations(reference: str = '', location=None) -> Quer
     )
 
 
+def annotate_transfer_order_allocations(reference: str = '', location=None) -> QuerySet:
+    """Annotate the total quantity of each part allocated to transfer orders.
+
+    - This function calculates the total part quantity allocated to open transfer orders"
+    - Finds all transfer order allocations for each part (using the provided filter)
+    - Aggregates the 'allocated quantity' for each relevant transfer order allocation item
+
+    Arguments:
+        reference: The relationship reference of the part from the current model
+        location: If provided, only allocated stock items from this location are considered
+    """
+    # Order filter only returns open orders
+    order_filter = Q(line__order__status__in=TransferOrderStatusGroups.OPEN)
+
+    if location is not None:
+        # Filter by location (including any child locations)
+
+        order_filter &= Q(
+            item__location__tree_id=location.tree_id,
+            item__location__lft__gte=location.lft,
+            item__location__rght__lte=location.rght,
+            item__location__level__gte=location.level,
+        )
+
+    return Coalesce(
+        SubquerySum(
+            f'{reference}stock_items__transfer_order_allocations__quantity',
+            filter=order_filter,
+        ),
+        Decimal(0),
+        output_field=models.DecimalField(),
+    )
+
+
 def variant_stock_query(reference: str = '', filter: Optional[Q] = None) -> QuerySet:
     """Create a queryset to retrieve all stock items for variant parts under the specified part.
 
diff --git a/src/backend/InvenTree/part/models.py b/src/backend/InvenTree/part/models.py
index a38870df5e..0548ffbef3 100644
--- a/src/backend/InvenTree/part/models.py
+++ b/src/backend/InvenTree/part/models.py
@@ -60,6 +60,7 @@ from order.status_codes import (
     PurchaseOrderStatus,
     PurchaseOrderStatusGroups,
     SalesOrderStatusGroups,
+    TransferOrderStatusGroups,
 )
 from stock import models as StockModels
 
@@ -1768,8 +1769,50 @@ class Part(
 
         return query['total']
 
+    def transfer_order_allocations(self, **kwargs):
+        """Return all transfer-order-allocation objects which allocate this part to a TransferOrder."""
+        include_variants = kwargs.get('include_variants', True)
+
+        queryset = OrderModels.TransferOrderAllocation.objects.all()
+
+        if include_variants:
+            # Include allocations for all variants
+            variants = self.get_descendants(include_self=True)
+            queryset = queryset.filter(item__part__in=variants)
+        else:
+            # Only look at this part
+            queryset = queryset.filter(item__part=self)
+
+        # Default behaviour is to only return *pending* allocations
+        pending = kwargs.get('pending', True)
+
+        if pending is True:
+            # Look only for 'open' orders
+            queryset = queryset.filter(
+                line__order__status__in=TransferOrderStatusGroups.OPEN
+            )
+        elif pending is False:
+            # Look only for 'closed' orders
+            queryset = queryset.exclude(
+                line__order__status__in=TransferOrderStatusGroups.OPEN
+            )
+
+        return queryset
+
+    def transfer_order_allocation_count(self, **kwargs):
+        """Return the total quantity of this part allocated to transfer orders."""
+        query = self.transfer_order_allocations(**kwargs).aggregate(
+            total=Coalesce(
+                Sum('quantity', output_field=models.DecimalField()),
+                0,
+                output_field=models.DecimalField(),
+            )
+        )
+
+        return query['total']
+
     def allocation_count(self, **kwargs):
-        """Return the total quantity of stock allocated for this part, against both build orders and sales orders."""
+        """Return the total quantity of stock allocated for this part, against build orders, sales orders, and transfer orders."""
         if self.id is None:
             # If this instance has not been saved, foreign-key lookups will fail
             return 0
@@ -1777,6 +1820,8 @@ class Part(
         return sum([
             self.build_order_allocation_count(**kwargs),
             self.sales_order_allocation_count(**kwargs),
+            # For now, stock allocated to a transfer order will not impact its availability
+            # self.transfer_order_allocation_count(**kwargs),
         ])
 
     def stock_entries(
diff --git a/src/backend/InvenTree/part/serializers.py b/src/backend/InvenTree/part/serializers.py
index f67f802a26..ccbce76492 100644
--- a/src/backend/InvenTree/part/serializers.py
+++ b/src/backend/InvenTree/part/serializers.py
@@ -735,6 +735,8 @@ class PartSerializer(
             ordering=part_filters.annotate_on_order_quantity(),
             in_stock=part_filters.annotate_total_stock(),
             allocated_to_sales_orders=part_filters.annotate_sales_order_allocations(),
+            # NOTE: for now, decided that allocations to Transfer Orders don't reduce available stock
+            # allocated_to_transfer_orders=part_filters.annotate_transfer_order_allocations(),
             allocated_to_build_orders=part_filters.annotate_build_order_allocations(),
         )
 
@@ -759,6 +761,8 @@ class PartSerializer(
                 ExpressionWrapper(
                     F('total_in_stock')
                     - F('allocated_to_sales_orders')
+                    # NOTE: for now, decided that allocations to Transfer Orders don't reduce available stock
+                    # - F('allocated_to_transfer_orders'),
                     - F('allocated_to_build_orders'),
                     output_field=models.DecimalField(),
                 ),
@@ -768,6 +772,8 @@ class PartSerializer(
         )
 
         # Annotate with the total 'required for builds' quantity
+        # NOTE: for now, we don't consider transfer orders for required quantities
+        #       and they are assumed to operate on stock that already exists.
         queryset = queryset.annotate(
             required_for_build_orders=part_filters.annotate_build_order_requirements(),
             required_for_sales_orders=part_filters.annotate_sales_order_requirements(),
@@ -1907,6 +1913,7 @@ class BomItemSerializer(
             'sub_part__stock_items',
             'sub_part__stock_items__allocations',
             'sub_part__stock_items__sales_order_allocations',
+            'sub_part__stock_items__transfer_order_allocations',
         )
 
         # Annotate with the 'total pricing' information based on unit pricing and quantity
diff --git a/src/backend/InvenTree/report/apps.py b/src/backend/InvenTree/report/apps.py
index 40de211e32..e72ea19145 100644
--- a/src/backend/InvenTree/report/apps.py
+++ b/src/backend/InvenTree/report/apps.py
@@ -229,6 +229,13 @@ class ReportConfig(AppConfig):
                 'model_type': 'returnorder',
                 'filename_pattern': 'ReturnOrder-{{ reference }}.pdf',
             },
+            {
+                'file': 'inventree_transfer_order_report.html',
+                'name': 'InvenTree Transfer Order',
+                'description': 'Sample transfer order report',
+                'model_type': 'transferorder',
+                'filename_pattern': 'TransferOrder-{{ reference }}.pdf',
+            },
             {
                 'file': 'inventree_test_report.html',
                 'name': 'InvenTree Test Report',
diff --git a/src/backend/InvenTree/report/templates/report/inventree_transfer_order_report.html b/src/backend/InvenTree/report/templates/report/inventree_transfer_order_report.html
new file mode 100644
index 0000000000..1b88d0275f
--- /dev/null
+++ b/src/backend/InvenTree/report/templates/report/inventree_transfer_order_report.html
@@ -0,0 +1,52 @@
+{% extends "report/inventree_order_report_base.html" %}
+
+{% load i18n %}
+{% load report %}
+{% load barcode %}
+{% load inventree_extras %}
+{% load markdownify %}
+
+{% block header_content %}
+
+    <div class='header-right'>
+        <h3>{% trans "Transfer Order" %} {{ prefix }}{{ reference }}</h3>
+        {{ order.take_from.pathstring }} → {{ order.destination.pathstring }}
+    </div>
+
+{% endblock header_content %}
+
+{% block page_content %}
+
+<h3>{% trans "Line Items" %}</h3>
+
+<table class='table table-striped table-condensed'>
+    <thead>
+        <tr>
+            <th>{% trans "Part" %}</th>
+            <th>{% trans "Reference" %}</th>
+            <th>{% trans "Quantity" %}</th>
+            <th>{% trans "Transferred" %}</th>
+            <th>{% trans "Note" %}</th>
+        </tr>
+    </thead>
+    <tbody>
+        {% for line in lines.all %}
+        <tr>
+            <td>
+                <div class='thumb-container'>
+                    <img src='{% part_image line.part height=240 %}' alt='{% trans "Part image" %}' class='part-thumb'>
+                </div>
+                <div class='part-text'>
+                    {{ line.part.full_name }}
+                </div>
+            </td>
+            <td>{{ line.reference }}</td>
+            <td>{% decimal line.quantity %}</td>
+            <td>{% decimal line.transferred %}</td>
+            <td>{{ line.notes }}</td>
+        </tr>
+        {% endfor %}
+    </tbody>
+</table>
+
+{% endblock page_content %}
diff --git a/src/backend/InvenTree/stock/api.py b/src/backend/InvenTree/stock/api.py
index 981bf6696d..b93b8edf2c 100644
--- a/src/backend/InvenTree/stock/api.py
+++ b/src/backend/InvenTree/stock/api.py
@@ -53,11 +53,12 @@ from InvenTree.mixins import (
     RetrieveUpdateDestroyAPI,
     SerializerContextMixin,
 )
-from order.models import PurchaseOrder, ReturnOrder, SalesOrder
+from order.models import PurchaseOrder, ReturnOrder, SalesOrder, TransferOrder
 from order.serializers import (
     PurchaseOrderSerializer,
     ReturnOrderSerializer,
     SalesOrderSerializer,
+    TransferOrderSerializer,
 )
 from part.models import BomItem, Part, PartCategory
 from part.serializers import PartBriefSerializer
@@ -672,13 +673,17 @@ class StockFilter(FilterSet):
     def filter_allocated(self, queryset, name, value):
         """Filter by whether or not the stock item is 'allocated'."""
         if str2bool(value):
-            # Filter StockItem with either build allocations or sales order allocations
+            # Filter StockItem with either build allocations or transfer order allocations or sales order allocations
             return queryset.filter(
-                Q(sales_order_allocations__isnull=False) | Q(allocations__isnull=False)
+                Q(sales_order_allocations__isnull=False)
+                | Q(transfer_order_allocations__isnull=False)
+                | Q(allocations__isnull=False)
             ).distinct()
-        # Filter StockItem without build allocations or sales order allocations
+        # Filter StockItem without build allocations or transfer order allocations or sales order allocations
         return queryset.filter(
-            Q(sales_order_allocations__isnull=True) & Q(allocations__isnull=True)
+            Q(sales_order_allocations__isnull=True)
+            & Q(transfer_order_allocations__isnull=True)
+            & Q(allocations__isnull=True)
         )
 
     expired = rest_filters.BooleanFilter(label='Expired', method='filter_expired')
@@ -1584,6 +1589,7 @@ class StockTrackingList(
             'purchaseorder': (PurchaseOrder, PurchaseOrderSerializer),
             'salesorder': (SalesOrder, SalesOrderSerializer),
             'returnorder': (ReturnOrder, ReturnOrderSerializer),
+            'transferorder': (TransferOrder, TransferOrderSerializer),
             'buildorder': (Build, BuildSerializer),
             'item': (StockItem, StockSerializers.StockItemSerializer),
             'stockitem': (StockItem, StockSerializers.StockItemSerializer),
diff --git a/src/backend/InvenTree/stock/models.py b/src/backend/InvenTree/stock/models.py
index 51daa040ce..040daee86e 100644
--- a/src/backend/InvenTree/stock/models.py
+++ b/src/backend/InvenTree/stock/models.py
@@ -47,6 +47,7 @@ from InvenTree.status_codes import (
     StockStatus,
     StockStatusGroups,
 )
+from order.status_codes import TransferOrderStatusGroups
 from part import models as PartModels
 from plugin.events import trigger_event
 from stock.events import StockEvents
@@ -1535,7 +1536,7 @@ class StockItem(
             item.save(add_note=False)
 
     def is_allocated(self):
-        """Return True if this StockItem is allocated to a SalesOrder or a Build."""
+        """Return True if this StockItem is allocated to a SalesOrder, TransferOrder, or a Build."""
         return self.allocation_count() > 0
 
     def build_allocation_count(self, **kwargs):
@@ -1595,12 +1596,48 @@ class StockItem(
 
         return total
 
+    def get_transfer_order_allocations(self, active=True, **kwargs):
+        """Return a queryset for TransferOrderAllocations against this StockItem, with optional filters.
+
+        Arguments:
+            active: Filter by 'active' status of the allocation
+        """
+        query = self.transfer_order_allocations.all()
+
+        if filter_allocations := kwargs.get('filter_allocations'):
+            query = query.filter(**filter_allocations)
+
+        if exclude_allocations := kwargs.get('exclude_allocations'):
+            query = query.exclude(**exclude_allocations)
+
+        if active is True:
+            query = query.filter(line__order__status__in=TransferOrderStatusGroups.OPEN)
+        elif active is False:
+            query = query.exclude(
+                line__order__status__in=TransferOrderStatusGroups.OPEN
+            )
+
+        return query
+
+    def transfer_order_allocation_count(self, active=True, **kwargs):
+        """Return the total quantity allocated to TransferOrders."""
+        query = self.get_transfer_order_allocations(active=active, **kwargs)
+        query = query.aggregate(q=Coalesce(Sum('quantity'), Decimal(0)))
+
+        total = query['q']
+
+        if total is None:
+            total = Decimal(0)
+
+        return total
+
     def allocation_count(self):
         """Return the total quantity allocated to builds or orders."""
         bo = self.build_allocation_count()
         so = self.sales_order_allocation_count()
+        to = self.transfer_order_allocation_count()
 
-        return bo + so
+        return bo + so + to
 
     def unallocated_quantity(self):
         """Return the quantity of this StockItem which is *not* allocated."""
@@ -2330,6 +2367,10 @@ class StockItem(
 
         deltas = {'stockitem': self.pk}
 
+        transferorder = kwargs.pop('transferorder', None)
+        if transferorder:
+            deltas['transferorder'] = transferorder.pk
+
         # Optional fields which can be supplied in a 'move' call
         for field in StockItem.optional_transfer_fields():
             if field in kwargs:
@@ -2478,6 +2519,10 @@ class StockItem(
             )
             tracking_info['old_status_logical'] = old_status_logical
 
+        transferorder = kwargs.pop('transferorder', None)
+        if transferorder:
+            tracking_info['transferorder'] = transferorder.pk
+
         # Optional fields which can be supplied in a 'move' call
         for field in StockItem.optional_transfer_fields():
             if field in kwargs:
@@ -2717,6 +2762,10 @@ class StockItem(
                     setattr(self, field, kwargs[field])
                     deltas[field] = kwargs[field]
 
+            transferorder = kwargs.pop('transferorder', None)
+            if transferorder:
+                deltas['transferorder'] = transferorder.pk
+
             self.save(add_note=False)
 
             self.add_tracking_entry(
diff --git a/src/backend/InvenTree/stock/serializers.py b/src/backend/InvenTree/stock/serializers.py
index a87de263dc..570b4f7e51 100644
--- a/src/backend/InvenTree/stock/serializers.py
+++ b/src/backend/InvenTree/stock/serializers.py
@@ -520,6 +520,8 @@ class StockItemSerializer(
             allocated=Coalesce(
                 SubquerySum('sales_order_allocations__quantity'), Decimal(0)
             )
+            # For now, stock allocated to a transfer order will not impact its availability
+            # + Coalesce(SubquerySum('transfer_order_allocations__quantity'), Decimal(0))
             + Coalesce(SubquerySum('allocations__quantity'), Decimal(0))
         )
 
@@ -1390,6 +1392,10 @@ class StockAssignmentItemSerializer(serializers.Serializer):
         if item.sales_order_allocations.count() > 0:
             raise ValidationError(_('Item is allocated to a sales order'))
 
+        # The item must not be allocated to a transfer order
+        if item.transfer_order_allocations.count() > 0:
+            raise ValidationError(_('Item is allocated to a transfer order'))
+
         # The item must not be allocated to a build order
         if item.allocations.count() > 0:
             raise ValidationError(_('Item is allocated to a build order'))
diff --git a/src/backend/InvenTree/users/oauth2_scopes.py b/src/backend/InvenTree/users/oauth2_scopes.py
index 123cb8d528..52656a33fa 100644
--- a/src/backend/InvenTree/users/oauth2_scopes.py
+++ b/src/backend/InvenTree/users/oauth2_scopes.py
@@ -20,6 +20,7 @@ _roles = {
     'purchase_order': 'Role Purchase Orders',
     'sales_order': 'Role Sales Orders',
     'return_order': 'Role Return Orders',
+    'transfer_order': 'Role Transfer Orders',
 }
 _methods = {'view': 'GET', 'add': 'POST', 'change': 'PUT / PATCH', 'delete': 'DELETE'}
 
diff --git a/src/backend/InvenTree/users/ruleset.py b/src/backend/InvenTree/users/ruleset.py
index 272a30d452..3787eb89b9 100644
--- a/src/backend/InvenTree/users/ruleset.py
+++ b/src/backend/InvenTree/users/ruleset.py
@@ -19,6 +19,7 @@ class RuleSetEnum(StringEnum):
     PURCHASE_ORDER = 'purchase_order'
     SALES_ORDER = 'sales_order'
     RETURN_ORDER = 'return_order'
+    TRANSFER_ORDER = 'transfer_order'
 
 
 # This is a list of all the ruleset choices available in the system.
@@ -34,6 +35,7 @@ RULESET_CHOICES = [
     (RuleSetEnum.PURCHASE_ORDER, _('Purchase Orders')),
     (RuleSetEnum.SALES_ORDER, _('Sales Orders')),
     (RuleSetEnum.RETURN_ORDER, _('Return Orders')),
+    (RuleSetEnum.TRANSFER_ORDER, _('Transfer Orders')),
 ]
 
 # Ruleset names available in the system.
@@ -161,6 +163,11 @@ def get_ruleset_models() -> dict:
             'order_returnorderlineitem',
             'order_returnorderextraline',
         ],
+        RuleSetEnum.TRANSFER_ORDER: [
+            'order_transferorder',
+            'order_transferorderallocation',
+            'order_transferorderlineitem',
+        ],
     }
 
     if settings.SITE_MULTI:
diff --git a/src/frontend/lib/enums/ApiEndpoints.tsx b/src/frontend/lib/enums/ApiEndpoints.tsx
index bc06ace42c..cfb6e5e498 100644
--- a/src/frontend/lib/enums/ApiEndpoints.tsx
+++ b/src/frontend/lib/enums/ApiEndpoints.tsx
@@ -199,6 +199,17 @@ export enum ApiEndpoints {
   return_order_line_list = 'order/ro-line/',
   return_order_extra_line_list = 'order/ro-extra-line/',
 
+  transfer_order_list = 'order/transfer-order/',
+  transfer_order_issue = 'order/transfer-order/:id/issue/',
+  transfer_order_hold = 'order/transfer-order/:id/hold/',
+  transfer_order_cancel = 'order/transfer-order/:id/cancel/',
+  transfer_order_complete = 'order/transfer-order/:id/complete/',
+  transfer_order_allocate = 'order/transfer-order/:id/allocate/',
+  transfer_order_allocate_serials = 'order/transfer-order/:id/allocate-serials/',
+
+  transfer_order_line_list = 'order/transfer-order-line/',
+  transfer_order_allocation_list = 'order/transfer-order-allocation/',
+
   // Template API endpoints
   label_list = 'label/template/',
   label_print = 'label/print/',
diff --git a/src/frontend/lib/enums/ModelInformation.tsx b/src/frontend/lib/enums/ModelInformation.tsx
index c9853d9b29..63aeb6dff5 100644
--- a/src/frontend/lib/enums/ModelInformation.tsx
+++ b/src/frontend/lib/enums/ModelInformation.tsx
@@ -207,6 +207,22 @@ export const ModelInformationDict: ModelDict = {
     api_endpoint: ApiEndpoints.return_order_line_list,
     icon: 'return_orders'
   },
+  transferorder: {
+    label: () => t`Transfer Order`,
+    label_multiple: () => t`Transfer Orders`,
+    url_overview: '/stock/location/index/transfer-orders',
+    url_detail: '/stock/transfer-order/:pk/',
+    api_endpoint: ApiEndpoints.transfer_order_list,
+    admin_url: '/order/transferorder/',
+    supports_barcode: true,
+    icon: 'transfer_orders'
+  },
+  transferorderlineitem: {
+    label: () => t`Transfer Order Line Item`,
+    label_multiple: () => t`Transfer Order Line Items`,
+    api_endpoint: ApiEndpoints.transfer_order_line_list,
+    icon: 'transfer-orders'
+  },
   address: {
     label: () => t`Address`,
     label_multiple: () => t`Addresses`,
diff --git a/src/frontend/lib/enums/ModelType.tsx b/src/frontend/lib/enums/ModelType.tsx
index 191d04545e..80c436b1b1 100644
--- a/src/frontend/lib/enums/ModelType.tsx
+++ b/src/frontend/lib/enums/ModelType.tsx
@@ -24,6 +24,8 @@ export enum ModelType {
   salesordershipment = 'salesordershipment',
   returnorder = 'returnorder',
   returnorderlineitem = 'returnorderlineitem',
+  transferorder = 'transferorder',
+  transferorderlineitem = 'transferorderlineitem',
   importsession = 'importsession',
   address = 'address',
   contact = 'contact',
diff --git a/src/frontend/lib/enums/Roles.tsx b/src/frontend/lib/enums/Roles.tsx
index 0f5aedd94c..3d7ff9c78b 100644
--- a/src/frontend/lib/enums/Roles.tsx
+++ b/src/frontend/lib/enums/Roles.tsx
@@ -11,6 +11,7 @@ export enum UserRoles {
   part_category = 'part_category',
   purchase_order = 'purchase_order',
   return_order = 'return_order',
+  transfer_order = 'transfer_order',
   sales_order = 'sales_order',
   stock = 'stock',
   stock_location = 'stock_location'
@@ -40,6 +41,8 @@ export function userRoleLabel(role: UserRoles): string {
       return t`Purchase Orders`;
     case UserRoles.return_order:
       return t`Return Orders`;
+    case UserRoles.transfer_order:
+      return t`Transfer Orders`;
     case UserRoles.sales_order:
       return t`Sales Orders`;
     case UserRoles.stock:
diff --git a/src/frontend/src/components/render/Instance.tsx b/src/frontend/src/components/render/Instance.tsx
index 329eb4dd32..191c56f2a2 100644
--- a/src/frontend/src/components/render/Instance.tsx
+++ b/src/frontend/src/components/render/Instance.tsx
@@ -51,7 +51,9 @@ import {
   RenderReturnOrder,
   RenderReturnOrderLineItem,
   RenderSalesOrder,
-  RenderSalesOrderShipment
+  RenderSalesOrderShipment,
+  RenderTransferOrder,
+  RenderTransferOrderLineItem
 } from './Order';
 import { RenderPart, RenderPartCategory, RenderPartTestTemplate } from './Part';
 import { RenderPlugin } from './Plugin';
@@ -87,6 +89,8 @@ export const RendererLookup: ModelRendererDict = {
   [ModelType.returnorderlineitem]: RenderReturnOrderLineItem,
   [ModelType.salesorder]: RenderSalesOrder,
   [ModelType.salesordershipment]: RenderSalesOrderShipment,
+  [ModelType.transferorder]: RenderTransferOrder,
+  [ModelType.transferorderlineitem]: RenderTransferOrderLineItem,
   [ModelType.stocklocation]: RenderStockLocation,
   [ModelType.stocklocationtype]: RenderStockLocationType,
   [ModelType.stockitem]: RenderStockItem,
diff --git a/src/frontend/src/components/render/Order.tsx b/src/frontend/src/components/render/Order.tsx
index e74915db18..c9475d7dea 100644
--- a/src/frontend/src/components/render/Order.tsx
+++ b/src/frontend/src/components/render/Order.tsx
@@ -123,3 +123,46 @@ export function RenderSalesOrderShipment({
     />
   );
 }
+
+/**
+ * Inline rendering of a single TransferOrder instance
+ */
+export function RenderTransferOrder(
+  props: Readonly<InstanceRenderInterface>
+): ReactNode {
+  const { instance } = props;
+
+  return (
+    <RenderInlineModel
+      {...props}
+      primary={instance.reference}
+      secondary={instance.description}
+      suffix={StatusRenderer({
+        status: instance.status_custom_key,
+        type: ModelType.transferorder
+      })}
+      url={
+        props.link
+          ? getDetailUrl(ModelType.transferorder, instance.pk)
+          : undefined
+      }
+    />
+  );
+}
+
+export function RenderTransferOrderLineItem(
+  props: Readonly<InstanceRenderInterface>
+): ReactNode {
+  const { instance } = props;
+
+  return (
+    <RenderInlineModel
+      {...props}
+      primary={instance.reference}
+      suffix={StatusRenderer({
+        status: instance.outcome,
+        type: ModelType.transferorderlineitem
+      })}
+    />
+  );
+}
diff --git a/src/frontend/src/defaults/backendMappings.tsx b/src/frontend/src/defaults/backendMappings.tsx
index 4754d9abb9..058ad80dbf 100644
--- a/src/frontend/src/defaults/backendMappings.tsx
+++ b/src/frontend/src/defaults/backendMappings.tsx
@@ -11,6 +11,8 @@ export const statusCodeList: Record<string, ModelType> = {
   PurchaseOrderStatus: ModelType.purchaseorder,
   ReturnOrderStatus: ModelType.returnorder,
   ReturnOrderLineStatus: ModelType.returnorderlineitem,
+  TransferOrderStatus: ModelType.transferorder,
+  TransferOrderLineStatus: ModelType.transferorderlineitem,
   SalesOrderStatus: ModelType.salesorder,
   StockHistoryCode: ModelType.stockhistory,
   StockStatus: ModelType.stockitem,
diff --git a/src/frontend/src/forms/TransferOrderForms.tsx b/src/frontend/src/forms/TransferOrderForms.tsx
new file mode 100644
index 0000000000..a7e3c8be3f
--- /dev/null
+++ b/src/frontend/src/forms/TransferOrderForms.tsx
@@ -0,0 +1,308 @@
+import { ApiEndpoints, ModelType, ProgressBar, apiUrl } from '@lib/index';
+import type { ApiFormFieldSet, ApiFormFieldType } from '@lib/types/Forms';
+import { t } from '@lingui/core/macro';
+import { Table } from '@mantine/core';
+import { IconCalendar, IconUsers } from '@tabler/icons-react';
+import { useMemo, useState } from 'react';
+import RemoveRowButton from '../components/buttons/RemoveRowButton';
+import { StandaloneField } from '../components/forms/StandaloneField';
+import type { TableFieldRowProps } from '../components/forms/fields/TableField';
+import { useCreateApiFormModal } from '../hooks/UseForm';
+import { useGlobalSettingsState } from '../states/SettingsStates';
+import { RenderPartColumn } from '../tables/ColumnRenderers';
+
+export function useTransferOrderFields({
+  duplicateOrderId
+}: {
+  duplicateOrderId?: number;
+}): ApiFormFieldSet {
+  const globalSettings = useGlobalSettingsState();
+
+  return useMemo(() => {
+    const fields: ApiFormFieldSet = {
+      reference: {},
+      description: {},
+      project_code: {},
+      start_date: {
+        icon: <IconCalendar />
+      },
+      target_date: {
+        icon: <IconCalendar />
+      },
+      take_from: {},
+      destination: {
+        filters: {
+          structural: false
+        }
+      },
+      consume: {},
+      link: {},
+      responsible: {
+        filters: {
+          is_active: true
+        },
+        icon: <IconUsers />
+      }
+    };
+
+    // Order duplication fields
+    if (!!duplicateOrderId) {
+      fields.duplicate = {
+        children: {
+          order_id: {
+            hidden: true,
+            value: duplicateOrderId
+          },
+          copy_lines: {},
+          // Transfer Orders don't have extra lines for now...
+          copy_extra_lines: { hidden: true, value: false }
+        }
+      };
+    }
+
+    if (!globalSettings.isSet('PROJECT_CODES_ENABLED', true)) {
+      delete fields.project_code;
+    }
+
+    return fields;
+  }, [duplicateOrderId, globalSettings]);
+}
+
+export function useTransferOrderLineItemFields({
+  orderId,
+  create
+}: {
+  orderId?: number;
+  create?: boolean;
+}): ApiFormFieldSet {
+  return useMemo(() => {
+    const fields: ApiFormFieldSet = {
+      order: {
+        filters: {},
+        disabled: true
+      },
+      part: {
+        filters: {
+          active: true,
+          virtual: false
+        }
+      },
+      reference: {},
+      quantity: {},
+      project_code: {
+        description: t`Select project code for this line item`
+      },
+      target_date: {},
+      notes: {},
+      link: {}
+    };
+
+    return fields;
+  }, [orderId, create]);
+}
+
+function TransferOrderAllocateLineRow({
+  props,
+  record,
+  sourceLocation
+}: Readonly<{
+  props: TableFieldRowProps;
+  record: any;
+  sourceLocation?: number | null;
+}>) {
+  // Statically defined field for selecting the stock item
+  const stockItemField: ApiFormFieldType = useMemo(() => {
+    return {
+      field_type: 'related field',
+      api_url: apiUrl(ApiEndpoints.stock_item_list),
+      model: ModelType.stockitem,
+      autoFill: true,
+      filters: {
+        available: true,
+        part_detail: true,
+        location_detail: true,
+        location: sourceLocation,
+        cascade: sourceLocation ? true : undefined,
+        part: record.part
+      },
+      value: props.item.stock_item,
+      name: 'stock_item',
+      onValueChange: (value: any, instance: any) => {
+        props.changeFn(props.idx, 'stock_item', value);
+
+        // Update the allocated quantity based on the selected stock item
+        if (instance) {
+          const available = instance.quantity - instance.allocated;
+          const required = record.quantity - record.allocated;
+
+          let quantity = props.item?.quantity ?? 0;
+
+          quantity = Math.max(quantity, required);
+          quantity = Math.min(quantity, available);
+
+          if (quantity != props.item.quantity) {
+            props.changeFn(props.idx, 'quantity', quantity);
+          }
+        }
+      }
+    };
+  }, [sourceLocation, record, props]);
+
+  // Statically defined field for selecting the allocation quantity
+  const quantityField: ApiFormFieldType = useMemo(() => {
+    return {
+      field_type: 'number',
+      name: 'quantity',
+      required: true,
+      value: props.item.quantity,
+      onValueChange: (value: any) => {
+        props.changeFn(props.idx, 'quantity', value);
+      }
+    };
+  }, [props]);
+
+  return (
+    <Table.Tr key={`table-row-${props.idx}-${record.pk}`}>
+      <Table.Td>
+        <RenderPartColumn part={record.part_detail} />
+      </Table.Td>
+      <Table.Td>
+        <ProgressBar
+          value={record.allocated}
+          maximum={record.quantity}
+          progressLabel
+        />
+      </Table.Td>
+      <Table.Td>
+        <StandaloneField
+          fieldName='stock_item'
+          fieldDefinition={stockItemField}
+          error={props.rowErrors?.stock_item?.message}
+        />
+      </Table.Td>
+      <Table.Td>
+        <StandaloneField
+          fieldName='quantity'
+          fieldDefinition={quantityField}
+          error={props.rowErrors?.quantity?.message}
+        />
+      </Table.Td>
+      <Table.Td>
+        <RemoveRowButton onClick={() => props.removeFn(props.idx)} />
+      </Table.Td>
+    </Table.Tr>
+  );
+}
+
+export function useAllocateToTransferOrderForm({
+  orderId,
+  sourceLocationId,
+  lineItems,
+  onFormSuccess
+}: {
+  orderId: number;
+  sourceLocationId?: number;
+  lineItems: any[];
+  onFormSuccess: (response: any) => void;
+}) {
+  const [sourceLocation, setSourceLocation] = useState<number | null>(
+    sourceLocationId || null
+  );
+
+  const fields: ApiFormFieldSet = useMemo(() => {
+    return {
+      // Non-submitted field to select the source location
+      source_location: {
+        exclude: true,
+        required: false,
+        value: sourceLocationId,
+        field_type: 'related field',
+        api_url: apiUrl(ApiEndpoints.stock_location_list),
+        model: ModelType.stocklocation,
+        label: t`Source Location`,
+        description: t`Select the source location for the stock allocation`,
+        onValueChange: (value: any) => {
+          setSourceLocation(value);
+        }
+      },
+      items: {
+        field_type: 'table',
+        value: [],
+        headers: [
+          { title: t`Part`, style: { minWidth: '200px' } },
+          { title: t`Allocated`, style: { minWidth: '200px' } },
+          { title: t`Stock Item`, style: { width: '100%' } },
+          { title: t`Quantity`, style: { minWidth: '200px' } },
+          { title: '', style: { width: '50px' } }
+        ],
+        modelRenderer: (row: TableFieldRowProps) => {
+          const record =
+            lineItems.find((item) => item.pk == row.item.line_item) ?? {};
+
+          return (
+            <TransferOrderAllocateLineRow
+              key={`table-row-${row.idx}-${record.pk}`}
+              props={row}
+              record={record}
+              sourceLocation={sourceLocation}
+            />
+          );
+        }
+      }
+    };
+  }, [orderId, lineItems, sourceLocation]);
+
+  return useCreateApiFormModal({
+    title: t`Allocate Stock`,
+    url: ApiEndpoints.transfer_order_allocate,
+    pk: orderId,
+    fields: fields,
+    onFormSuccess: onFormSuccess,
+    successMessage: t`Stock items allocated`,
+    size: '80%',
+    initialData: {
+      items: lineItems.map((item) => {
+        return {
+          line_item: item.pk,
+          quantity: 0,
+          stock_item: null
+        };
+      })
+    }
+  });
+}
+
+export function useTransferOrderAllocationFields({
+  orderId
+}: {
+  orderId?: number;
+}): ApiFormFieldSet {
+  return useMemo(() => {
+    return {
+      item: {
+        // Cannot change item, but display for reference
+        disabled: true
+      },
+      quantity: {}
+    };
+  }, [orderId]);
+}
+
+export function useTransferOrderAllocateSerialsFields({
+  itemId,
+  orderId
+}: {
+  itemId: number;
+  orderId: number;
+}): ApiFormFieldSet {
+  return useMemo(() => {
+    return {
+      line_item: {
+        value: itemId,
+        hidden: true
+      },
+      quantity: {},
+      serial_numbers: {}
+    };
+  }, [itemId, orderId]);
+}
diff --git a/src/frontend/src/functions/icons.tsx b/src/frontend/src/functions/icons.tsx
index 00f9726f80..e169f89e79 100644
--- a/src/frontend/src/functions/icons.tsx
+++ b/src/frontend/src/functions/icons.tsx
@@ -21,6 +21,7 @@ import {
   IconCancel,
   IconCheck,
   IconCircleCheck,
+  IconCircleDashedCheck,
   IconCircleMinus,
   IconCirclePlus,
   IconCircleX,
@@ -148,11 +149,13 @@ const icons: InvenTreeIconType = {
   build_order: IconTools,
   builds: IconTools,
   used_in: IconStack2,
+  consume: IconCircleDashedCheck,
   manufacturers: IconBuildingFactory2,
   suppliers: IconBuilding,
   customers: IconBuildingStore,
   purchase_orders: IconShoppingCart,
   return_orders: IconTruckReturn,
+  transfer_orders: IconTransfer,
   sales_orders: IconTruckDelivery,
   scheduling: IconCalendarStats,
   scrap: IconCircleX,
diff --git a/src/frontend/src/pages/Index/Settings/SystemSettings.tsx b/src/frontend/src/pages/Index/Settings/SystemSettings.tsx
index bd5c368b8f..409110efee 100644
--- a/src/frontend/src/pages/Index/Settings/SystemSettings.tsx
+++ b/src/frontend/src/pages/Index/Settings/SystemSettings.tsx
@@ -13,6 +13,7 @@ import {
   IconQrcode,
   IconServerCog,
   IconShoppingCart,
+  IconTransfer,
   IconTruckDelivery
 } from '@tabler/icons-react';
 import { useMemo } from 'react';
@@ -363,6 +364,20 @@ export default function SystemSettings() {
           </Stack>
         )
       },
+      {
+        name: 'transferorders',
+        label: t`Transfer Orders`,
+        icon: <IconTransfer />,
+        content: (
+          <GlobalSettingList
+            keys={[
+              'TRANSFERORDER_ENABLED',
+              'TRANSFERORDER_REFERENCE_PATTERN',
+              'TRANSFERORDER_REQUIRE_RESPONSIBLE'
+            ]}
+          />
+        )
+      },
       {
         name: 'plugins',
         label: t`Plugins`,
diff --git a/src/frontend/src/pages/part/PartDetail.tsx b/src/frontend/src/pages/part/PartDetail.tsx
index 209711b9b2..a42157c7d1 100644
--- a/src/frontend/src/pages/part/PartDetail.tsx
+++ b/src/frontend/src/pages/part/PartDetail.tsx
@@ -30,6 +30,7 @@ import {
   IconStack2,
   IconTestPipe,
   IconTools,
+  IconTransfer,
   IconTruckDelivery,
   IconTruckReturn,
   IconVersions
@@ -101,6 +102,7 @@ import { RelatedPartTable } from '../../tables/part/RelatedPartTable';
 import { ReturnOrderTable } from '../../tables/sales/ReturnOrderTable';
 import { SalesOrderTable } from '../../tables/sales/SalesOrderTable';
 import { StockItemTable } from '../../tables/stock/StockItemTable';
+import { TransferOrderTable } from '../../tables/stock/TransferOrderTable';
 import PartAllocationPanel from './PartAllocationPanel';
 import PartPricingPanel from './PartPricingPanel';
 import PartStockHistoryDetail from './PartStockHistoryDetail';
@@ -771,6 +773,20 @@ export default function PartDetail() {
         hidden: !part.assembly || !user.hasViewRole(UserRoles.build),
         content: part.pk ? <BuildOrderTable partId={part.pk} /> : <Skeleton />
       },
+      {
+        name: 'transfer_orders',
+        label: t`Transfer Orders`,
+        icon: <IconTransfer />,
+        hidden:
+          part.virtual ||
+          !globalSettings.isSet('TRANSFERORDER_ENABLED') ||
+          !user.hasViewRole(UserRoles.transfer_order),
+        content: part.pk ? (
+          <TransferOrderTable partId={part.pk} />
+        ) : (
+          <Skeleton />
+        )
+      },
       {
         name: 'stocktake',
         label: t`Stock History`,
diff --git a/src/frontend/src/pages/stock/LocationDetail.tsx b/src/frontend/src/pages/stock/LocationDetail.tsx
index 629f95d83d..5a3f0e50c7 100644
--- a/src/frontend/src/pages/stock/LocationDetail.tsx
+++ b/src/frontend/src/pages/stock/LocationDetail.tsx
@@ -8,11 +8,13 @@ import type { PanelType } from '@lib/types/Panel';
 import { t } from '@lingui/core/macro';
 import { Group, Skeleton, Stack } from '@mantine/core';
 import {
+  IconCalendar,
   IconInfoCircle,
   IconListDetails,
   IconPackages,
   IconSitemap,
-  IconTable
+  IconTable,
+  IconTransfer
 } from '@tabler/icons-react';
 import { useMemo, useState } from 'react';
 import { useNavigate, useParams } from 'react-router-dom';
@@ -20,6 +22,7 @@ import { api } from '../../App';
 import { useBarcodeScanDialog } from '../../components/barcodes/BarcodeScanDialog';
 import AdminButton from '../../components/buttons/AdminButton';
 import { PrintingActions } from '../../components/buttons/PrintingActions';
+import OrderCalendar from '../../components/calendar/OrderCalendar';
 import {
   type DetailsField,
   DetailsTable
@@ -48,11 +51,14 @@ import {
 import { useInstance } from '../../hooks/UseInstance';
 import { useStockAdjustActions } from '../../hooks/UseStockAdjustActions';
 import { useUserSettingsState } from '../../states/SettingsStates';
+import { useGlobalSettingsState } from '../../states/SettingsStates';
 import { useUserState } from '../../states/UserState';
 import { PartListTable } from '../../tables/part/PartTable';
 import { StockItemTable } from '../../tables/stock/StockItemTable';
 import StockLocationParametricTable from '../../tables/stock/StockLocationParametricTable';
 import { StockLocationTable } from '../../tables/stock/StockLocationTable';
+import TransferOrderParametricTable from '../../tables/stock/TransferOrderParametricTable';
+import { TransferOrderTable } from '../../tables/stock/TransferOrderTable';
 
 export default function Stock() {
   const { id: _id } = useParams();
@@ -65,6 +71,7 @@ export default function Stock() {
   const navigate = useNavigate();
   const user = useUserState();
   const settings = useUserSettingsState();
+  const globalSettings = useGlobalSettingsState();
 
   const [treeOpen, setTreeOpen] = useState(false);
 
@@ -169,6 +176,7 @@ export default function Stock() {
   }, [location, instanceQuery]);
 
   const [sublocationView, setSublocationView] = useState<string>('table');
+  const [transferOrderView, setTransferOrderView] = useState<string>('table');
 
   const locationPanels: PanelType[] = useMemo(() => {
     return [
@@ -219,6 +227,42 @@ export default function Stock() {
           />
         )
       },
+      SegmentedControlPanel({
+        name: 'transfer-orders',
+        label: t`Transfer Orders`,
+        icon: <IconTransfer />,
+        hidden:
+          !user.hasViewRole(UserRoles.transfer_order) ||
+          !globalSettings.isSet('TRANSFERORDER_ENABLED'),
+        selection: transferOrderView,
+        onChange: setTransferOrderView,
+        options: [
+          {
+            value: 'table',
+            label: t`Table View`,
+            icon: <IconTable />,
+            content: <TransferOrderTable />
+          },
+          {
+            value: 'calendar',
+            label: t`Calendar View`,
+            icon: <IconCalendar />,
+            content: (
+              <OrderCalendar
+                model={ModelType.transferorder}
+                role={UserRoles.transfer_order}
+                params={{ outstanding: true }}
+              />
+            )
+          },
+          {
+            value: 'parametric',
+            label: t`Parametric View`,
+            icon: <IconListDetails />,
+            content: <TransferOrderParametricTable />
+          }
+        ]
+      }),
       {
         name: 'default_parts',
         label: t`Default Parts`,
@@ -240,7 +284,7 @@ export default function Stock() {
         hidden: !location.pk
       })
     ];
-  }, [sublocationView, location, id]);
+  }, [sublocationView, transferOrderView, location, id]);
 
   const editLocation = useEditApiFormModal({
     url: ApiEndpoints.stock_location_list,
diff --git a/src/frontend/src/pages/stock/StockDetail.tsx b/src/frontend/src/pages/stock/StockDetail.tsx
index 88fe30945f..da674823b2 100644
--- a/src/frontend/src/pages/stock/StockDetail.tsx
+++ b/src/frontend/src/pages/stock/StockDetail.tsx
@@ -88,6 +88,7 @@ import InstalledItemsTable from '../../tables/stock/InstalledItemsTable';
 import { StockItemTable } from '../../tables/stock/StockItemTable';
 import StockItemTestResultTable from '../../tables/stock/StockItemTestResultTable';
 import { StockTrackingTable } from '../../tables/stock/StockTrackingTable';
+import TransferOrderAllocationTable from '../../tables/stock/TransferOrderAllocationTable';
 
 export default function StockDetail() {
   const { id } = useParams();
@@ -476,6 +477,13 @@ export default function StockDetail() {
     return stockitem?.part_detail?.salable;
   }, [stockitem]);
 
+  const showTransferAllocations: boolean = useMemo(() => {
+    return (
+      !stockitem?.part_detail?.virtual &&
+      globalSettings.isSet('TRANSFERORDER_ENABLED')
+    );
+  }, [stockitem]);
+
   // API query to determine if this stock item has trackable BOM items
   const trackedBomItemQuery = useQuery({
     queryKey: ['tracked-bom-item', stockitem.pk, stockitem.part],
@@ -544,11 +552,17 @@ export default function StockDetail() {
         icon: <IconBookmark />,
         hidden:
           !stockitem.in_stock ||
-          (!showSalesAllocations && !showBuildAllocations),
+          (!showSalesAllocations &&
+            !showBuildAllocations &&
+            !showTransferAllocations),
         content: (
           <Accordion
             multiple={true}
-            defaultValue={['buildAllocations', 'salesAllocations']}
+            defaultValue={[
+              'buildAllocations',
+              'salesAllocations',
+              'transferAllocations'
+            ]}
           >
             {showBuildAllocations && (
               <Accordion.Item value='buildAllocations' key='buildAllocations'>
@@ -580,6 +594,24 @@ export default function StockDetail() {
                 </Accordion.Panel>
               </Accordion.Item>
             )}
+            {showTransferAllocations && (
+              <Accordion.Item
+                value='transferAllocations'
+                key='transferAllocations'
+              >
+                <Accordion.Control>
+                  <StylishText size='lg'>{t`Transfer Order Allocations`}</StylishText>
+                </Accordion.Control>
+                <Accordion.Panel>
+                  <TransferOrderAllocationTable
+                    stockId={stockitem.pk}
+                    modelField='order'
+                    modelTarget={ModelType.transferorder}
+                    showOrderInfo
+                  />
+                </Accordion.Panel>
+              </Accordion.Item>
+            )}
           </Accordion>
         )
       },
diff --git a/src/frontend/src/pages/stock/TransferOrderDetail.tsx b/src/frontend/src/pages/stock/TransferOrderDetail.tsx
new file mode 100644
index 0000000000..5d06fa2732
--- /dev/null
+++ b/src/frontend/src/pages/stock/TransferOrderDetail.tsx
@@ -0,0 +1,552 @@
+import { t } from '@lingui/core/macro';
+import { Grid, Skeleton, Stack } from '@mantine/core';
+import { type ReactNode, useMemo } from 'react';
+import { useParams } from 'react-router-dom';
+
+import { ApiEndpoints } from '@lib/enums/ApiEndpoints';
+import { ModelType } from '@lib/enums/ModelType';
+import { UserRoles } from '@lib/enums/Roles';
+import { type PanelType, apiUrl } from '@lib/index';
+import {
+  IconBookmark,
+  IconInfoCircle,
+  IconList,
+  IconListCheck
+} from '@tabler/icons-react';
+import AdminButton from '../../components/buttons/AdminButton';
+import PrimaryActionButton from '../../components/buttons/PrimaryActionButton';
+import { PrintingActions } from '../../components/buttons/PrintingActions';
+import {
+  type DetailsField,
+  DetailsTable
+} from '../../components/details/Details';
+import { ItemDetailsGrid } from '../../components/details/ItemDetails';
+import {
+  BarcodeActionDropdown,
+  CancelItemAction,
+  DuplicateItemAction,
+  EditItemAction,
+  HoldItemAction,
+  OptionsActionDropdown
+} from '../../components/items/ActionDropdown';
+import InstanceDetail from '../../components/nav/InstanceDetail';
+import { PageDetail } from '../../components/nav/PageDetail';
+import AttachmentPanel from '../../components/panels/AttachmentPanel';
+import NotesPanel from '../../components/panels/NotesPanel';
+import { PanelGroup } from '../../components/panels/PanelGroup';
+import ParametersPanel from '../../components/panels/ParametersPanel';
+import { StatusRenderer } from '../../components/render/StatusRenderer';
+import { useTransferOrderFields } from '../../forms/TransferOrderForms';
+import {
+  useCreateApiFormModal,
+  useEditApiFormModal
+} from '../../hooks/UseForm';
+import { useInstance } from '../../hooks/UseInstance';
+import useStatusCodes from '../../hooks/UseStatusCodes';
+import { useGlobalSettingsState } from '../../states/SettingsStates';
+import { useUserState } from '../../states/UserState';
+import TransferOrderAllocationTable from '../../tables/stock/TransferOrderAllocationTable';
+import TransferOrderLineItemTable from '../../tables/stock/TransferOrderLineItemTable';
+
+export default function TransferOrderDetail() {
+  const { id } = useParams();
+
+  const user = useUserState();
+
+  const globalSettings = useGlobalSettingsState();
+
+  const {
+    instance: order,
+    instanceQuery,
+    refreshInstance
+  } = useInstance({
+    endpoint: ApiEndpoints.transfer_order_list,
+    pk: id,
+    params: {}
+  });
+
+  const toStatus = useStatusCodes({ modelType: ModelType.transferorder });
+
+  const lineItemsEditable: boolean = useMemo(() => {
+    const orderOpen: boolean =
+      order.status != toStatus.COMPLETE && order.status != toStatus.CANCELLED;
+
+    return orderOpen;
+    // TODO: does this setting make any sense for Transfer Orders???
+    // if (orderOpen) {
+    //     return true;
+    // } else {
+    //     return globalSettings.isSet('TRANSFERORDER_EDIT_COMPLETED_ORDERS');
+    // }
+  }, [globalSettings, order.status, toStatus]);
+
+  // for now, only permit editing allocations when line items can be edited
+  const allocationsEditable = lineItemsEditable;
+
+  const orderOpen = useMemo(() => {
+    return (
+      order.status == toStatus.PENDING ||
+      order.status == toStatus.ISSUED ||
+      order.status == toStatus.ON_HOLD
+    );
+  }, [order, toStatus]);
+
+  const detailsPanel = useMemo(() => {
+    if (instanceQuery.isFetching) {
+      return <Skeleton />;
+    }
+
+    const tl: DetailsField[] = [
+      {
+        type: 'text',
+        name: 'reference',
+        label: t`Reference`,
+        copy: true
+      },
+      {
+        type: 'link',
+        name: 'take_from',
+        icon: 'location',
+        label: t`Source Location`,
+        model: ModelType.stocklocation
+      },
+      {
+        type: 'link',
+        name: 'destination',
+        icon: 'location',
+        label: t`Destination Location`,
+        model: ModelType.stocklocation
+      },
+      {
+        type: 'text',
+        name: 'description',
+        label: t`Description`,
+        copy: true
+      },
+      {
+        type: 'status',
+        name: 'status',
+        label: t`Status`,
+        model: ModelType.transferorder
+      },
+      {
+        type: 'status',
+        name: 'status_custom_key',
+        label: t`Custom Status`,
+        model: ModelType.transferorder,
+        icon: 'status',
+        hidden:
+          !order.status_custom_key || order.status_custom_key == order.status
+      }
+    ];
+
+    const tr: DetailsField[] = [
+      {
+        type: 'boolean',
+        name: 'consume',
+        icon: 'consume',
+        label: t`Consume Stock`
+      },
+      {
+        type: 'text',
+        name: 'line_items',
+        label: t`Line Items`,
+        icon: 'list'
+      },
+      {
+        type: 'progressbar',
+        name: 'completed',
+        icon: 'progress',
+        label: t`Completed Line Items`,
+        total: order.line_items,
+        progress: order.completed_lines
+      }
+    ];
+
+    const bl: DetailsField[] = [
+      {
+        type: 'link',
+        external: true,
+        name: 'link',
+        label: t`Link`,
+        copy: true,
+        hidden: !order.link
+      },
+      {
+        type: 'text',
+        name: 'project_code_label',
+        label: t`Project Code`,
+        icon: 'reference',
+        copy: true,
+        hidden: !order.project_code
+      },
+      {
+        type: 'text',
+        name: 'responsible',
+        label: t`Responsible`,
+        badge: 'owner',
+        hidden: !order.responsible
+      }
+    ];
+
+    const br: DetailsField[] = [
+      {
+        type: 'date',
+        name: 'creation_date',
+        label: t`Creation Date`,
+        icon: 'calendar',
+        copy: true,
+        hidden: !order.creation_date
+      },
+      {
+        type: 'date',
+        name: 'issue_date',
+        label: t`Issue Date`,
+        icon: 'calendar',
+        copy: true,
+        hidden: !order.issue_date
+      },
+      {
+        type: 'date',
+        name: 'start_date',
+        label: t`Start Date`,
+        icon: 'calendar',
+        copy: true,
+        hidden: !order.start_date
+      },
+      {
+        type: 'date',
+        name: 'target_date',
+        label: t`Target Date`,
+        copy: true,
+        hidden: !order.target_date
+      },
+      {
+        type: 'date',
+        name: 'complete_date',
+        icon: 'calendar_check',
+        label: t`Completion Date`,
+        copy: true,
+        hidden: !order.complete_date
+      }
+    ];
+
+    return (
+      <ItemDetailsGrid>
+        <Grid grow>
+          {/* TODO: what image do we show for a Transfer Order? */}
+          {/* <DetailsImage
+                        appRole={UserRoles.transfer_order}
+                        apiPath={ApiEndpoints.transfer_order_list}
+                        src="/static/img/blank_image.png"
+                        pk={order.pk}
+                    /> */}
+          <Grid.Col span={{ base: 12, sm: 8 }}>
+            <DetailsTable fields={tl} item={order} />
+          </Grid.Col>
+        </Grid>
+        <DetailsTable fields={tr} item={order} />
+        <DetailsTable fields={bl} item={order} />
+        <DetailsTable fields={br} item={order} />
+      </ItemDetailsGrid>
+    );
+  }, [order, instanceQuery]);
+
+  const orderPanels: PanelType[] = useMemo(() => {
+    return [
+      {
+        name: 'detail',
+        label: t`Order Details`,
+        icon: <IconInfoCircle />,
+        content: detailsPanel
+      },
+      {
+        name: 'line-items',
+        label: t`Line Items`,
+        icon: <IconList />,
+        content: (
+          <TransferOrderLineItemTable
+            orderId={order.pk}
+            sourceLocationId={order.take_from}
+            orderDetailRefresh={refreshInstance}
+            editable={lineItemsEditable}
+          />
+          // TODO: add back the accordion if we need extra lines
+          // <Accordion
+          //     multiple={true}
+          //     defaultValue={[
+          //         'line-items',
+          //         // 'extra-items'
+          //     ]}
+          // >
+          //     <Accordion.Item value='line-items' key='lineitems'>
+          //         <Accordion.Control>
+          //             <StylishText size='lg'>{t`Line Items`}</StylishText>
+          //         </Accordion.Control>
+          //         <Accordion.Panel>
+          //             <TransferOrderLineItemTable
+          //                 orderId={order.pk}
+          //                 orderDetailRefresh={refreshInstance}
+          //                 editable={lineItemsEditable}
+          //             />
+          //         </Accordion.Panel>
+          //     </Accordion.Item>
+          //     {/* <Accordion.Item value='extra-items' key='extraitems'>
+          //         <Accordion.Control>
+          //             <StylishText size='lg'>{t`Extra Line Items`}</StylishText>
+          //         </Accordion.Control>
+          //         <Accordion.Panel>
+          //             <ExtraLineItemTable
+          //                 endpoint={ApiEndpoints.sales_order_extra_line_list}
+          //                 orderId={order.pk}
+          //                 editable={lineItemsEditable}
+          //                 orderDetailRefresh={refreshInstance}
+          //                 currency={orderCurrency}
+          //                 role={UserRoles.sales_order}
+          //             />
+          //         </Accordion.Panel>
+          //     </Accordion.Item> */}
+          // </Accordion>
+        )
+      },
+      {
+        name: 'allocations',
+        label:
+          order.status != toStatus.COMPLETE
+            ? t`Allocated Stock`
+            : t`Transferred Stock`,
+        icon:
+          order.status != toStatus.COMPLETE ? (
+            <IconBookmark />
+          ) : (
+            <IconListCheck />
+          ),
+        content: (
+          <TransferOrderAllocationTable
+            orderId={order.pk}
+            showPartInfo
+            allowEdit={allocationsEditable}
+            modelField='item'
+            modelTarget={ModelType.stockitem}
+          />
+        )
+      },
+      ParametersPanel({
+        model_type: ModelType.transferorder,
+        model_id: order.pk
+      }),
+      AttachmentPanel({
+        model_type: ModelType.transferorder,
+        model_id: order.pk
+      }),
+      NotesPanel({
+        model_type: ModelType.transferorder,
+        model_id: order.pk
+      })
+    ];
+  }, [order, id, user]);
+
+  const orderBadges: ReactNode[] = useMemo(() => {
+    return instanceQuery.isLoading
+      ? []
+      : [
+          <StatusRenderer
+            status={order.status_custom_key}
+            type={ModelType.transferorder}
+            options={{ size: 'lg' }}
+          />
+        ];
+  }, [order, instanceQuery]);
+
+  const transferOrderFields = useTransferOrderFields({});
+
+  const duplicateTransferOrderFields = useTransferOrderFields({
+    duplicateOrderId: order.pk
+  });
+
+  const editTransferOrder = useEditApiFormModal({
+    url: ApiEndpoints.transfer_order_list,
+    pk: order.pk,
+    title: t`Edit Transfer Order`,
+    fields: transferOrderFields,
+    onFormSuccess: () => {
+      refreshInstance();
+    }
+  });
+
+  const duplicateTransferOrderInitialData = useMemo(() => {
+    const data = { ...order };
+    // if we set the reference to null/undefined, it will be left blank in the form
+    // if we omit the reference altogether, it will be auto-generated via reference pattern
+    // from the OPTIONS response
+    delete data.reference;
+    return data;
+  }, [order]);
+
+  const duplicateTransferOrder = useCreateApiFormModal({
+    url: ApiEndpoints.transfer_order_list,
+    title: t`Add Transfer Order`,
+    fields: duplicateTransferOrderFields,
+    initialData: duplicateTransferOrderInitialData,
+    modelType: ModelType.transferorder,
+    follow: true
+  });
+
+  const issueOrder = useCreateApiFormModal({
+    url: apiUrl(ApiEndpoints.transfer_order_issue, order.pk),
+    title: t`Issue Transfer Order`,
+    onFormSuccess: refreshInstance,
+    preFormWarning: t`Issue this order`,
+    successMessage: t`Order issued`
+  });
+
+  const cancelOrder = useCreateApiFormModal({
+    url: apiUrl(ApiEndpoints.transfer_order_cancel, order.pk),
+    title: t`Cancel Transfer Order`,
+    onFormSuccess: refreshInstance,
+    preFormWarning: t`Cancel this order`,
+    successMessage: t`Order cancelled`
+  });
+
+  const holdOrder = useCreateApiFormModal({
+    url: apiUrl(ApiEndpoints.transfer_order_hold, order.pk),
+    title: t`Hold Transfer Order`,
+    onFormSuccess: refreshInstance,
+    preFormWarning: t`Place this order on hold`,
+    successMessage: t`Order placed on hold`
+  });
+
+  const completeOrder = useCreateApiFormModal({
+    url: apiUrl(ApiEndpoints.transfer_order_complete, order.pk),
+    title: t`Complete Transfer Order`,
+    onFormSuccess: refreshInstance,
+    preFormWarning: t`Mark this order as complete`,
+    successMessage: t`Order completed`,
+    fields: {
+      accept_incomplete_allocation: {}
+    }
+  });
+
+  const orderActions = useMemo(() => {
+    const canEdit: boolean = user.hasChangeRole(UserRoles.transfer_order);
+
+    const canIssue: boolean =
+      canEdit &&
+      (order.status == toStatus.PENDING || order.status == toStatus.ON_HOLD);
+
+    const canHold: boolean =
+      canEdit &&
+      (order.status == toStatus.PENDING || order.status == toStatus.ISSUED);
+
+    const canCancel: boolean =
+      canEdit &&
+      (order.status == toStatus.PENDING || order.status == toStatus.ON_HOLD);
+
+    const canComplete: boolean = canEdit && order.status == toStatus.ISSUED;
+
+    return [
+      <PrimaryActionButton
+        title={t`Issue Order`}
+        icon='issue'
+        hidden={!canIssue}
+        color='blue'
+        onClick={() => issueOrder.open()}
+      />,
+      <PrimaryActionButton
+        title={t`Complete Order`}
+        icon='complete'
+        hidden={!canComplete}
+        color='green'
+        onClick={() => completeOrder.open()}
+      />,
+      <AdminButton model={ModelType.transferorder} id={order.pk} />,
+      <BarcodeActionDropdown
+        model={ModelType.transferorder}
+        pk={order.pk}
+        hash={order?.barcode_hash}
+      />,
+      <PrintingActions
+        modelType={ModelType.transferorder}
+        items={[order.pk]}
+        enableReports
+        enableLabels
+      />,
+      <OptionsActionDropdown
+        tooltip={t`Order Actions`}
+        actions={[
+          EditItemAction({
+            hidden: !user.hasChangeRole(UserRoles.transfer_order),
+            tooltip: t`Edit order`,
+            onClick: () => {
+              editTransferOrder.open();
+            }
+          }),
+          DuplicateItemAction({
+            tooltip: t`Duplicate order`,
+            hidden: !user.hasChangeRole(UserRoles.transfer_order),
+            onClick: () => duplicateTransferOrder.open()
+          }),
+          HoldItemAction({
+            tooltip: t`Hold order`,
+            hidden: !canHold,
+            onClick: () => holdOrder.open()
+          }),
+          CancelItemAction({
+            tooltip: t`Cancel order`,
+            hidden: !canCancel,
+            onClick: () => cancelOrder.open()
+          })
+        ]}
+      />
+    ];
+  }, [user, order, orderOpen, toStatus]);
+
+  const subtitle: string = useMemo(() => {
+    const t = order.take_from_detail?.pathstring || '';
+    const d = order.destination_detail?.pathstring || '';
+    return `${t} → ${d}`;
+  }, [order]);
+
+  return (
+    <>
+      {editTransferOrder.modal}
+      {issueOrder.modal}
+      {cancelOrder.modal}
+      {holdOrder.modal}
+      {completeOrder.modal}
+      {duplicateTransferOrder.modal}
+      <InstanceDetail
+        query={instanceQuery}
+        requiredRole={UserRoles.transfer_order}
+      >
+        <Stack gap='xs'>
+          <PageDetail
+            title={`${t`Transfer Order`}: ${order.reference}`}
+            subtitle={subtitle}
+            // What should be the Transfer Order image?
+            // imageUrl={order.customer_detail?.image}
+            badges={orderBadges}
+            actions={orderActions}
+            breadcrumbs={[{ name: t`Stock`, url: '/stock/' }]}
+            lastCrumb={[
+              {
+                name: order.reference,
+                url: `/stock/transfer-order/${order.pk}`
+              }
+            ]}
+            editAction={editTransferOrder.open}
+            editEnabled={user.hasChangePermission(ModelType.transferorder)}
+          />
+          <PanelGroup
+            pageKey='transferorder'
+            panels={orderPanels}
+            model={ModelType.transferorder}
+            reloadInstance={instanceQuery.refetch}
+            instance={order}
+            id={order.pk}
+          />
+        </Stack>
+      </InstanceDetail>
+    </>
+  );
+}
diff --git a/src/frontend/src/router.tsx b/src/frontend/src/router.tsx
index 49b580fcfa..ddeb3a2136 100644
--- a/src/frontend/src/router.tsx
+++ b/src/frontend/src/router.tsx
@@ -88,6 +88,10 @@ export const ReturnOrderDetail = Loadable(
   lazy(() => import('./pages/sales/ReturnOrderDetail'))
 );
 
+export const TransferOrderDetail = Loadable(
+  lazy(() => import('./pages/stock/TransferOrderDetail'))
+);
+
 export const Scan = Loadable(lazy(() => import('./pages/Index/Scan')));
 
 export const ErrorPage = Loadable(lazy(() => import('./pages/ErrorPage')));
@@ -169,6 +173,7 @@ export const routes = (
         <Route index element={<Navigate to='location/index/' />} />
         <Route path='location/:id?/*' element={<LocationDetail />} />
         <Route path='item/:id/*' element={<StockDetail />} />
+        <Route path='transfer-order/:id/*' element={<TransferOrderDetail />} />
       </Route>
       <Route path='manufacturing/'>
         <Route index element={<Navigate to='index/' />} />
diff --git a/src/frontend/src/tables/stock/StockTrackingTable.tsx b/src/frontend/src/tables/stock/StockTrackingTable.tsx
index 748fde47f5..6e91c8b5b9 100644
--- a/src/frontend/src/tables/stock/StockTrackingTable.tsx
+++ b/src/frontend/src/tables/stock/StockTrackingTable.tsx
@@ -15,7 +15,8 @@ import { RenderCompany } from '../../components/render/Company';
 import {
   RenderPurchaseOrder,
   RenderReturnOrder,
-  RenderSalesOrder
+  RenderSalesOrder,
+  RenderTransferOrder
 } from '../../components/render/Order';
 import { RenderPart } from '../../components/render/Part';
 import { StatusRenderer } from '../../components/render/StatusRenderer';
@@ -181,6 +182,17 @@ export function StockTrackingTable({
               navigate: navigate
             })
         },
+        {
+          label: t`Transfer Order`,
+          key: 'transferorder',
+          details:
+            deltas.transferorder_detail &&
+            RenderTransferOrder({
+              instance: deltas.transferorder_detail,
+              link: true,
+              navigate: navigate
+            })
+        },
         {
           label: t`Customer`,
           key: 'customer',
diff --git a/src/frontend/src/tables/stock/TransferOrderAllocationTable.tsx b/src/frontend/src/tables/stock/TransferOrderAllocationTable.tsx
new file mode 100644
index 0000000000..b1fc696ab1
--- /dev/null
+++ b/src/frontend/src/tables/stock/TransferOrderAllocationTable.tsx
@@ -0,0 +1,285 @@
+import { type RowAction, RowEditAction } from '@lib/components/RowActions';
+import { ApiEndpoints } from '@lib/enums/ApiEndpoints';
+import { ModelType } from '@lib/enums/ModelType';
+import { UserRoles } from '@lib/enums/Roles';
+import { apiUrl } from '@lib/functions/Api';
+import useTable from '@lib/hooks/UseTable';
+import type { TableFilter } from '@lib/types/Filters';
+import type { StockOperationProps } from '@lib/types/Forms';
+import type { TableColumn } from '@lib/types/Tables';
+import { t } from '@lingui/core/macro';
+import { Alert } from '@mantine/core';
+import { IconCircleX } from '@tabler/icons-react';
+import { useCallback, useMemo, useState } from 'react';
+import { useTransferOrderAllocationFields } from '../../forms/TransferOrderForms';
+import {
+  useDeleteApiFormModal,
+  useEditApiFormModal
+} from '../../hooks/UseForm';
+import { useStockAdjustActions } from '../../hooks/UseStockAdjustActions';
+import { useUserState } from '../../states/UserState';
+import {
+  DescriptionColumn,
+  LocationColumn,
+  PartColumn,
+  ReferenceColumn,
+  StatusColumn
+} from '../ColumnRenderers';
+import { IncludeVariantsFilter, StockLocationFilter } from '../Filter';
+import { InvenTreeTable } from '../InvenTreeTable';
+
+export default function TransferOrderAllocationTable({
+  partId,
+  stockId,
+  orderId,
+  lineItemId,
+  showPartInfo,
+  showOrderInfo,
+  allowEdit,
+  isSubTable,
+  modelTarget,
+  modelField
+}: Readonly<{
+  partId?: number;
+  stockId?: number;
+  orderId?: number;
+  lineItemId?: number;
+  showPartInfo?: boolean;
+  showOrderInfo?: boolean;
+  allowEdit?: boolean;
+  isSubTable?: boolean;
+  modelTarget?: ModelType;
+  modelField?: string;
+}>) {
+  const user = useUserState();
+
+  const tableId = useMemo(() => {
+    let id = 'transferorderallocations';
+
+    if (!!partId) {
+      id += '-part';
+    }
+
+    if (isSubTable) {
+      id += '-sub';
+    }
+
+    return id;
+  }, [partId, isSubTable]);
+
+  const table = useTable(tableId);
+
+  const [selectedAllocation, setSelectedAllocation] = useState<number>(0);
+
+  const tableFilters: TableFilter[] = useMemo(() => {
+    const filters: TableFilter[] = [
+      {
+        name: 'outstanding',
+        label: t`Outstanding`,
+        description: t`Show outstanding allocations`
+      },
+      StockLocationFilter()
+    ];
+
+    if (!!partId) {
+      filters.push(IncludeVariantsFilter());
+    }
+
+    return filters;
+  }, [partId]);
+
+  const tableColumns: TableColumn[] = useMemo(() => {
+    return [
+      ReferenceColumn({
+        accessor: 'order_detail.reference',
+        title: t`Transfer Order`,
+        switchable: false,
+        sortable: true,
+        hidden: showOrderInfo != true
+      }),
+      DescriptionColumn({
+        accessor: 'order_detail.description',
+        hidden: showOrderInfo != true
+      }),
+      StatusColumn({
+        accessor: 'order_detail.status',
+        model: ModelType.transferorder,
+        title: t`Order Status`,
+        hidden: showOrderInfo != true
+      }),
+      PartColumn({
+        hidden: showPartInfo != true,
+        part: 'part_detail'
+      }),
+      DescriptionColumn({
+        accessor: 'part_detail.description',
+        hidden: showPartInfo != true
+      }),
+      {
+        accessor: 'part_detail.IPN',
+        title: t`IPN`,
+        hidden: showPartInfo != true,
+        sortable: true,
+        ordering: 'IPN'
+      },
+      {
+        accessor: 'serial',
+        title: t`Serial Number`,
+        sortable: true,
+        switchable: true,
+        render: (record: any) => record?.item_detail?.serial
+      },
+      {
+        accessor: 'batch',
+        title: t`Batch Code`,
+        sortable: true,
+        switchable: true,
+        render: (record: any) => record?.item_detail?.batch
+      },
+      {
+        accessor: 'available',
+        title: t`Available Quantity`,
+        sortable: false,
+        hidden: isSubTable,
+        render: (record: any) => record?.item_detail?.quantity
+      },
+      {
+        accessor: 'quantity',
+        title: t`Allocated Quantity`,
+        sortable: true
+      },
+      LocationColumn({
+        accessor: 'location_detail',
+        switchable: true,
+        sortable: true
+      })
+    ];
+  }, [showOrderInfo, showPartInfo, isSubTable]);
+
+  const editAllocationFields = useTransferOrderAllocationFields({
+    orderId: orderId
+  });
+
+  const editAllocation = useEditApiFormModal({
+    url: ApiEndpoints.transfer_order_allocation_list,
+    pk: selectedAllocation,
+    fields: editAllocationFields,
+    title: t`Edit Allocation`,
+    onFormSuccess: () => table.refreshTable()
+  });
+
+  const deleteAllocation = useDeleteApiFormModal({
+    url: ApiEndpoints.transfer_order_allocation_list,
+    pk: selectedAllocation,
+    title: t`Remove Allocated Stock`,
+    preFormContent: (
+      <Alert color='red' title={t`Confirm Removal`}>
+        {t`Are you sure you want to remove this allocated stock from the order?`}
+      </Alert>
+    ),
+    submitText: t`Remove`,
+    onFormSuccess: () => table.refreshTable()
+  });
+
+  const rowActions = useCallback(
+    (record: any): RowAction[] => {
+      return [
+        RowEditAction({
+          tooltip: t`Edit Allocation`,
+          hidden: !allowEdit || !user.hasChangeRole(UserRoles.transfer_order),
+          onClick: () => {
+            setSelectedAllocation(record.pk);
+            editAllocation.open();
+          }
+        }),
+        {
+          title: t`Remove`,
+          tooltip: t`Remove allocated stock`,
+          icon: <IconCircleX />,
+          color: 'red',
+          hidden: !allowEdit || !user.hasDeleteRole(UserRoles.transfer_order),
+          onClick: () => {
+            setSelectedAllocation(record.pk);
+            deleteAllocation.open();
+          }
+        }
+      ];
+    },
+    [allowEdit, user]
+  );
+
+  const stockOperationProps: StockOperationProps = useMemo(() => {
+    // Extract stock items from the selected records
+    // Note that the table is actually a list of TransferOrderAllocation instances,
+    // so we need to reconstruct the stock item details
+    const stockItems: any[] = table.selectedRecords
+      .filter((item: any) => !!item.item_detail)
+      .map((item: any) => {
+        return {
+          ...item.item_detail,
+          part_detail: item.part_detail,
+          location_detail: item.location_detail
+        };
+      });
+
+    return {
+      items: stockItems,
+      model: ModelType.stockitem,
+      refresh: table.refreshTable
+    };
+  }, [table.selectedRecords, table.refreshTable]);
+
+  const stockAdjustActions = useStockAdjustActions({
+    formProps: stockOperationProps,
+    merge: false,
+    assign: false,
+    delete: false,
+    add: false,
+    count: false,
+    remove: false
+  });
+
+  const tableActions = useMemo(() => {
+    return [stockAdjustActions.dropdown];
+  }, [allowEdit, orderId, user, stockAdjustActions.dropdown]);
+
+  return (
+    <>
+      {editAllocation.modal}
+      {deleteAllocation.modal}
+      {!isSubTable && stockAdjustActions.modals.map((modal) => modal.modal)}
+      <InvenTreeTable
+        url={apiUrl(ApiEndpoints.transfer_order_allocation_list)}
+        tableState={table}
+        columns={tableColumns}
+        props={{
+          params: {
+            part_detail: showPartInfo ?? false,
+            order_detail: showOrderInfo ?? false,
+            item_detail: true,
+            location_detail: true,
+            line: lineItemId,
+            part: partId,
+            order: orderId,
+            item: stockId
+          },
+          enableSearch: !isSubTable,
+          enableRefresh: !isSubTable,
+          enableColumnSwitching: !isSubTable,
+          enableFilters: !isSubTable,
+          enableDownload: !isSubTable,
+          enableSelection: !isSubTable,
+          minHeight: isSubTable ? 100 : undefined,
+          rowActions: rowActions,
+          tableActions: isSubTable ? undefined : tableActions,
+          tableFilters: tableFilters,
+          modelField: modelField ?? 'order',
+          enableReports: !isSubTable,
+          enableLabels: !isSubTable,
+          printingAccessor: 'item',
+          modelType: modelTarget ?? ModelType.transferorder
+        }}
+      />
+    </>
+  );
+}
diff --git a/src/frontend/src/tables/stock/TransferOrderLineItemTable.tsx b/src/frontend/src/tables/stock/TransferOrderLineItemTable.tsx
new file mode 100644
index 0000000000..531ef4da69
--- /dev/null
+++ b/src/frontend/src/tables/stock/TransferOrderLineItemTable.tsx
@@ -0,0 +1,529 @@
+import { ApiEndpoints } from '@lib/enums/ApiEndpoints';
+import { apiUrl } from '@lib/functions/Api';
+import useTable from '@lib/hooks/UseTable';
+import {
+  ActionButton,
+  AddItemButton,
+  ModelType,
+  ProgressBar,
+  RowDeleteAction,
+  RowDuplicateAction,
+  RowEditAction,
+  RowViewAction,
+  UserRoles,
+  formatDecimal
+} from '@lib/index';
+import type { TableFilter } from '@lib/types/Filters';
+import type { RowAction, TableColumn } from '@lib/types/Tables';
+import { t } from '@lingui/core/macro';
+import { Group, Paper, Text } from '@mantine/core';
+import {
+  IconArrowRight,
+  IconHash,
+  IconShoppingCart,
+  IconSquareArrowRight,
+  IconTools
+} from '@tabler/icons-react';
+import type { DataTableRowExpansionProps } from 'mantine-datatable';
+import { type ReactNode, useCallback, useMemo, useState } from 'react';
+import { useNavigate } from 'react-router-dom';
+import { RenderPart } from '../../components/render/Part';
+import OrderPartsWizard from '../../components/wizards/OrderPartsWizard';
+import { useBuildOrderFields } from '../../forms/BuildForms';
+import {
+  useAllocateToTransferOrderForm,
+  useTransferOrderAllocateSerialsFields,
+  useTransferOrderLineItemFields
+} from '../../forms/TransferOrderForms';
+import {
+  useCreateApiFormModal,
+  useDeleteApiFormModal,
+  useEditApiFormModal
+} from '../../hooks/UseForm';
+import { useUserState } from '../../states/UserState';
+import {
+  DateColumn,
+  DecimalColumn,
+  DescriptionColumn,
+  LinkColumn,
+  ProjectCodeColumn,
+  RenderPartColumn
+} from '../ColumnRenderers';
+import { InvenTreeTable } from '../InvenTreeTable';
+import RowExpansionIcon from '../RowExpansionIcon';
+import { TableHoverCard } from '../TableHoverCard';
+import TransferOrderAllocationTable from './TransferOrderAllocationTable';
+
+export default function TransferOrderLineItemTable({
+  orderId,
+  sourceLocationId,
+  orderDetailRefresh,
+  editable
+}: Readonly<{
+  orderId: number;
+  sourceLocationId?: number;
+  orderDetailRefresh: () => void;
+  editable: boolean;
+}>) {
+  const navigate = useNavigate();
+  const user = useUserState();
+  const table = useTable('transfer-order-line-item');
+
+  const tableColumns: TableColumn[] = useMemo(() => {
+    return [
+      {
+        accessor: 'part',
+        sortable: true,
+        switchable: false,
+        minWidth: 175,
+        render: (record: any) => {
+          return (
+            <Group wrap='nowrap'>
+              {record.part_detail?.virtual || (
+                <RowExpansionIcon
+                  enabled={record.allocated}
+                  expanded={table.isRowExpanded(record.pk)}
+                />
+              )}
+              <RenderPartColumn part={record.part_detail} />
+            </Group>
+          );
+        }
+      },
+      {
+        accessor: 'part_detail.IPN',
+        title: t`IPN`,
+        switchable: true
+      },
+      DescriptionColumn({
+        accessor: 'part_detail.description'
+      }),
+      {
+        accessor: 'reference',
+        sortable: false,
+        switchable: true
+      },
+      ProjectCodeColumn({}),
+      DecimalColumn({
+        accessor: 'quantity',
+        sortable: true
+      }),
+      DateColumn({
+        accessor: 'target_date',
+        sortable: true,
+        title: t`Target Date`
+      }),
+      {
+        accessor: 'stock',
+        title: t`Available Stock`,
+        render: (record: any) => {
+          if (record.part_detail?.virtual) {
+            return <Text size='sm' fs='italic'>{t`Virtual part`}</Text>;
+          }
+
+          const part_stock = record?.available_stock ?? 0;
+          const variant_stock = record?.available_variant_stock ?? 0;
+          const available = part_stock + variant_stock;
+
+          const required = Math.max(
+            record.quantity - record.allocated - record.shipped,
+            0
+          );
+
+          let color: string | undefined;
+          let text = `${formatDecimal(available)}`;
+
+          const extra: ReactNode[] = [];
+
+          if (available <= 0) {
+            color = 'red';
+            text = t`No stock available`;
+          } else if (available < required) {
+            color = 'orange';
+          }
+
+          if (variant_stock > 0) {
+            extra.push(<Text size='sm'>{t`Includes variant stock`}</Text>);
+          }
+
+          if (record.building > 0) {
+            extra.push(
+              <Text size='sm'>
+                {t`In production`}: {formatDecimal(record.building)}
+              </Text>
+            );
+          }
+
+          if (record.on_order > 0) {
+            extra.push(
+              <Text size='sm'>
+                {t`On order`}: {formatDecimal(record.on_order)}
+              </Text>
+            );
+          }
+
+          return (
+            <TableHoverCard
+              value={<Text c={color}>{text}</Text>}
+              extra={extra}
+              title={t`Stock Information`}
+            />
+          );
+        }
+      },
+
+      {
+        accessor: 'allocated',
+        sortable: true,
+        render: (record: any) => {
+          if (record.part_detail?.virtual) {
+            return <Text size='sm' fs='italic'>{t`Virtual part`}</Text>;
+          }
+
+          return (
+            <ProgressBar
+              progressLabel={true}
+              value={record.allocated}
+              maximum={record.quantity}
+            />
+          );
+        }
+      },
+      {
+        accessor: 'transferred',
+        title: t`Transferred`,
+        sortable: true,
+        render: (record: any) => {
+          if (record.part_detail?.virtual) {
+            return <Text size='sm' fs='italic'>{t`Virtual part`}</Text>;
+          }
+
+          return (
+            <ProgressBar
+              progressLabel={true}
+              value={record.transferred}
+              maximum={record.quantity}
+            />
+          );
+        }
+      },
+      {
+        accessor: 'notes'
+      },
+      LinkColumn({
+        accessor: 'link'
+      })
+    ];
+  }, [table.isRowExpanded]);
+
+  const [initialData, setInitialData] = useState({});
+  const [selectedItems, setSelectedItems] = useState<any[]>([]);
+  const [selectedLineId, setSelectedLineId] = useState<number>(0);
+  const [selectedPart, setSelectedPart] = useState<any>(null);
+  const [partsToOrder, setPartsToOrder] = useState<any[]>([]);
+
+  const allocateStock = useAllocateToTransferOrderForm({
+    orderId: orderId,
+    lineItems: selectedItems.filter(
+      (item) => item.part_detail?.virtual !== true
+    ),
+    sourceLocationId: sourceLocationId,
+    onFormSuccess: () => {
+      table.refreshTable();
+      table.clearSelectedRecords();
+    }
+  });
+
+  const orderPartsWizard = OrderPartsWizard({
+    parts: partsToOrder
+  });
+
+  const buildOrderFields = useBuildOrderFields({
+    create: true,
+    modalId: 'build-order-create-from-transfer-order'
+  });
+
+  const newBuildOrder = useCreateApiFormModal({
+    url: ApiEndpoints.build_order_list,
+    title: t`Create Build Order`,
+    modalId: 'build-order-create-from-transfer-order',
+    fields: buildOrderFields,
+    initialData: initialData,
+    follow: true,
+    modelType: ModelType.build
+  });
+
+  const createLineFields = useTransferOrderLineItemFields({
+    orderId: orderId,
+    create: true
+  });
+
+  const newLine = useCreateApiFormModal({
+    url: ApiEndpoints.transfer_order_line_list,
+    title: t`Add Line Item`,
+    fields: createLineFields,
+    initialData: {
+      ...initialData
+    },
+    onFormSuccess: orderDetailRefresh,
+    table: table
+  });
+
+  const editLineFields = useTransferOrderLineItemFields({
+    orderId: orderId,
+    create: false
+  });
+
+  const editLine = useEditApiFormModal({
+    url: ApiEndpoints.transfer_order_line_list,
+    pk: selectedLineId,
+    title: t`Edit Line Item`,
+    fields: editLineFields,
+    onFormSuccess: orderDetailRefresh,
+    table: table
+  });
+
+  const deleteLine = useDeleteApiFormModal({
+    url: ApiEndpoints.transfer_order_line_list,
+    pk: selectedLineId,
+    title: t`Delete Line Item`,
+    onFormSuccess: orderDetailRefresh,
+    table: table
+  });
+
+  const allocateSerialFields = useTransferOrderAllocateSerialsFields({
+    itemId: selectedLineId,
+    orderId: orderId
+  });
+
+  const allocateBySerials = useCreateApiFormModal({
+    url: ApiEndpoints.transfer_order_allocate_serials,
+    pk: orderId,
+    title: t`Allocate Serial Numbers`,
+    preFormContent: selectedPart ? (
+      <Paper withBorder p='sm'>
+        <RenderPart instance={selectedPart} />
+      </Paper>
+    ) : undefined,
+    initialData: initialData,
+    fields: allocateSerialFields,
+    table: table
+  });
+
+  const tableActions = useMemo(() => {
+    return [
+      <AddItemButton
+        key='add-transfer-order-line-item'
+        tooltip={t`Add Line Item`}
+        onClick={() => {
+          setInitialData({
+            order: orderId
+          });
+          newLine.open();
+        }}
+        hidden={!editable || !user.hasAddRole(UserRoles.transfer_order)}
+      />,
+      <ActionButton
+        key='order-parts'
+        hidden={!user.hasAddRole(UserRoles.purchase_order)}
+        disabled={!table.hasSelectedRecords}
+        tooltip={t`Order Parts`}
+        icon={<IconShoppingCart />}
+        color='blue'
+        onClick={() => {
+          setPartsToOrder(table.selectedRecords.map((r) => r.part_detail));
+          orderPartsWizard.openWizard();
+        }}
+      />,
+      <ActionButton
+        key='allocate-stock'
+        tooltip={t`Allocate Stock`}
+        icon={<IconArrowRight />}
+        disabled={!table.hasSelectedRecords}
+        color='green'
+        onClick={() => {
+          setSelectedItems(
+            table.selectedRecords.filter((r: any) => r.allocated < r.quantity)
+          );
+          allocateStock.open();
+        }}
+      />
+    ];
+  }, [user, orderId, table.hasSelectedRecords, table.selectedRecords]);
+
+  const rowActions = useCallback(
+    (record: any): RowAction[] => {
+      const allocated = (record?.allocated ?? 0) > (record?.quantity ?? 0);
+      const virtual = record?.part_detail?.virtual ?? false;
+
+      return [
+        {
+          hidden:
+            allocated ||
+            virtual ||
+            !editable ||
+            !user.hasChangeRole(UserRoles.transfer_order),
+          title: t`Allocate Stock`,
+          icon: <IconSquareArrowRight />,
+          color: 'green',
+          onClick: () => {
+            setSelectedItems([record]);
+            allocateStock.open();
+          }
+        },
+        {
+          hidden:
+            !record?.part_detail?.trackable ||
+            allocated ||
+            virtual ||
+            !editable ||
+            !user.hasChangeRole(UserRoles.transfer_order),
+          title: t`Allocate serials`,
+          icon: <IconHash />,
+          color: 'green',
+          onClick: () => {
+            setSelectedLineId(record.pk);
+            setSelectedPart(record?.part_detail ?? null);
+            setInitialData({
+              quantity: record.quantity - record.allocated
+            });
+            allocateBySerials.open();
+          }
+        },
+        {
+          hidden:
+            allocated ||
+            virtual ||
+            !user.hasAddRole(UserRoles.build) ||
+            !record?.part_detail?.assembly,
+          title: t`Build stock`,
+          icon: <IconTools />,
+          color: 'blue',
+          onClick: () => {
+            setInitialData({
+              part: record.part,
+              quantity: (record?.quantity ?? 1) - (record?.allocated ?? 0),
+              transfer_order: orderId
+            });
+            newBuildOrder.open();
+          }
+        },
+        {
+          hidden:
+            allocated ||
+            virtual ||
+            !user.hasAddRole(UserRoles.purchase_order) ||
+            !record?.part_detail?.purchaseable,
+          title: t`Order stock`,
+          icon: <IconShoppingCart />,
+          color: 'blue',
+          onClick: () => {
+            setPartsToOrder([record.part_detail]);
+            orderPartsWizard.openWizard();
+          }
+        },
+        RowEditAction({
+          hidden: !editable || !user.hasChangeRole(UserRoles.transfer_order),
+          onClick: () => {
+            setSelectedLineId(record.pk);
+            editLine.open();
+          }
+        }),
+        RowDuplicateAction({
+          hidden: !editable || !user.hasAddRole(UserRoles.transfer_order),
+          onClick: () => {
+            setInitialData(record);
+            newLine.open();
+          }
+        }),
+        RowDeleteAction({
+          hidden: !editable || !user.hasDeleteRole(UserRoles.transfer_order),
+          onClick: () => {
+            setSelectedLineId(record.pk);
+            deleteLine.open();
+          }
+        }),
+        RowViewAction({
+          title: t`View Part`,
+          modelType: ModelType.part,
+          modelId: record.part,
+          navigate: navigate,
+          hidden: !user.hasViewRole(UserRoles.part)
+        })
+      ];
+    },
+    [navigate, user, editable]
+  );
+
+  // Control row expansion
+  const rowExpansion: DataTableRowExpansionProps<any> = useMemo(() => {
+    return {
+      allowMultiple: true,
+      expandable: ({ record }: { record: any }) => {
+        if (record?.part_detail?.virtual) {
+          return false;
+        }
+        return table.isRowExpanded(record.pk) || record.allocated > 0;
+      },
+      content: ({ record }: { record: any }) => {
+        return (
+          <TransferOrderAllocationTable
+            showOrderInfo={false}
+            showPartInfo={false}
+            orderId={orderId}
+            lineItemId={record.pk}
+            partId={record.part}
+            allowEdit={editable}
+            modelTarget={ModelType.stockitem}
+            modelField={'item'}
+            isSubTable
+          />
+        );
+      }
+    };
+  }, [orderId, table.isRowExpanded]);
+
+  const tableFilters: TableFilter[] = useMemo(() => {
+    return [
+      {
+        name: 'allocated',
+        label: t`Allocated`,
+        description: t`Show lines which are fully allocated`
+      },
+      {
+        name: 'completed',
+        label: t`Completed`,
+        description: t`Show lines which are completed`
+      }
+    ];
+  }, []);
+
+  return (
+    <>
+      {editLine.modal}
+      {deleteLine.modal}
+      {newLine.modal}
+      {newBuildOrder.modal}
+      {allocateBySerials.modal}
+      {allocateStock.modal}
+      {orderPartsWizard.wizard}
+      <InvenTreeTable
+        url={apiUrl(ApiEndpoints.transfer_order_line_list)}
+        tableState={table}
+        columns={tableColumns}
+        props={{
+          enableSelection: true,
+          enableDownload: true,
+          params: {
+            order: orderId,
+            part_detail: true
+          },
+          rowActions: rowActions,
+          tableActions: tableActions,
+          tableFilters: tableFilters,
+          rowExpansion: rowExpansion
+        }}
+      />
+    </>
+  );
+}
diff --git a/src/frontend/src/tables/stock/TransferOrderParametricTable.tsx b/src/frontend/src/tables/stock/TransferOrderParametricTable.tsx
new file mode 100644
index 0000000000..0bdba4fcee
--- /dev/null
+++ b/src/frontend/src/tables/stock/TransferOrderParametricTable.tsx
@@ -0,0 +1,48 @@
+import { ApiEndpoints } from '@lib/enums/ApiEndpoints';
+import { ModelType } from '@lib/enums/ModelType';
+import type { TableFilter } from '@lib/types/Filters';
+import type { TableColumn } from '@lib/types/Tables';
+import { type ReactNode, useMemo } from 'react';
+import { DescriptionColumn, ReferenceColumn } from '../ColumnRenderers';
+import {
+  AssignedToMeFilter,
+  OrderStatusFilter,
+  OutstandingFilter,
+  OverdueFilter,
+  ProjectCodeFilter,
+  ResponsibleFilter
+} from '../Filter';
+import ParametricDataTable from '../general/ParametricDataTable';
+
+export default function TransferOrderParametricTable({
+  queryParams
+}: {
+  queryParams?: Record<string, any>;
+}): ReactNode {
+  const customColumns: TableColumn[] = useMemo(() => {
+    return [ReferenceColumn({ switchable: false }), DescriptionColumn({})];
+  }, []);
+
+  const customFilters: TableFilter[] = useMemo(() => {
+    return [
+      OrderStatusFilter({ model: ModelType.transferorder }),
+      OutstandingFilter(),
+      OverdueFilter(),
+      AssignedToMeFilter(),
+      ProjectCodeFilter(),
+      ResponsibleFilter()
+    ];
+  }, []);
+
+  return (
+    <ParametricDataTable
+      modelType={ModelType.transferorder}
+      endpoint={ApiEndpoints.transfer_order_list}
+      customColumns={customColumns}
+      customFilters={customFilters}
+      queryParams={{
+        ...queryParams
+      }}
+    />
+  );
+}
diff --git a/src/frontend/src/tables/stock/TransferOrderTable.tsx b/src/frontend/src/tables/stock/TransferOrderTable.tsx
new file mode 100644
index 0000000000..a799bf4e38
--- /dev/null
+++ b/src/frontend/src/tables/stock/TransferOrderTable.tsx
@@ -0,0 +1,185 @@
+import { ApiEndpoints } from '@lib/enums/ApiEndpoints';
+import { ModelType } from '@lib/enums/ModelType';
+import { apiUrl } from '@lib/functions/Api';
+import { AddItemButton, UserRoles, useTable } from '@lib/index';
+import type { TableFilter } from '@lib/types/Filters';
+import { t } from '@lingui/core/macro';
+import { useMemo } from 'react';
+import { useTransferOrderFields } from '../../forms/TransferOrderForms';
+import { useCreateApiFormModal } from '../../hooks/UseForm';
+import { useUserState } from '../../states/UserState';
+import {
+  BooleanColumn,
+  CompletionDateColumn,
+  CreatedByColumn,
+  CreationDateColumn,
+  DescriptionColumn,
+  LocationColumn,
+  ProjectCodeColumn,
+  ReferenceColumn,
+  ResponsibleColumn,
+  StartDateColumn,
+  StatusColumn,
+  TargetDateColumn
+} from '../ColumnRenderers';
+import {
+  AssignedToMeFilter,
+  CompletedAfterFilter,
+  CompletedBeforeFilter,
+  CreatedAfterFilter,
+  CreatedBeforeFilter,
+  CreatedByFilter,
+  HasProjectCodeFilter,
+  IncludeVariantsFilter,
+  MaxDateFilter,
+  MinDateFilter,
+  OrderStatusFilter,
+  OutstandingFilter,
+  OverdueFilter,
+  ProjectCodeFilter,
+  ResponsibleFilter,
+  StartDateAfterFilter,
+  StartDateBeforeFilter,
+  TargetDateAfterFilter,
+  TargetDateBeforeFilter
+} from '../Filter';
+import { InvenTreeTable } from '../InvenTreeTable';
+
+export function TransferOrderTable({
+  partId
+}: Readonly<{
+  partId?: number;
+}>) {
+  const table = useTable(
+    !!partId ? 'transferorders-part' : 'transferorders-index'
+  );
+  const user = useUserState();
+
+  const tableFilters: TableFilter[] = useMemo(() => {
+    const filters: TableFilter[] = [
+      OrderStatusFilter({ model: ModelType.transferorder }),
+      OutstandingFilter(),
+      OverdueFilter(),
+      AssignedToMeFilter(),
+      MinDateFilter(),
+      MaxDateFilter(),
+      CreatedBeforeFilter(),
+      CreatedAfterFilter(),
+      TargetDateBeforeFilter(),
+      TargetDateAfterFilter(),
+      StartDateBeforeFilter(),
+      StartDateAfterFilter(),
+      {
+        name: 'has_target_date',
+        type: 'boolean',
+        label: t`Has Target Date`,
+        description: t`Show orders with a target date`
+      },
+      {
+        name: 'has_start_date',
+        type: 'boolean',
+        label: t`Has Start Date`,
+        description: t`Show orders with a start date`
+      },
+      CompletedBeforeFilter(),
+      CompletedAfterFilter(),
+      HasProjectCodeFilter(),
+      ProjectCodeFilter(),
+      ResponsibleFilter(),
+      CreatedByFilter()
+    ];
+
+    if (!!partId) {
+      filters.push(IncludeVariantsFilter());
+    }
+
+    return filters;
+  }, [partId]);
+
+  const tableColumns = useMemo(() => {
+    return [
+      ReferenceColumn({}),
+      DescriptionColumn({}),
+      LocationColumn({
+        accessor: 'take_from_detail',
+        title: t`Source Location`
+      }),
+      LocationColumn({
+        accessor: 'destination_detail',
+        title: t`Destination Location`
+      }),
+      BooleanColumn({
+        accessor: 'consume',
+        title: t`Consume Stock`,
+        sortable: true,
+        switchable: true
+      }),
+      //   LineItemsProgressColumn({}),
+      StatusColumn({ model: ModelType.transferorder }),
+      ProjectCodeColumn({
+        defaultVisible: false
+      }),
+      CreationDateColumn({
+        defaultVisible: false
+      }),
+      CreatedByColumn({
+        defaultVisible: false
+      }),
+      StartDateColumn({
+        defaultVisible: false
+      }),
+      TargetDateColumn({}),
+      CompletionDateColumn({
+        accessor: 'complete_date'
+      }),
+      ResponsibleColumn({})
+    ];
+  }, []);
+
+  const transferOrderFields = useTransferOrderFields({});
+
+  const newTransferOrder = useCreateApiFormModal({
+    url: ApiEndpoints.transfer_order_list,
+    title: t`Add Transfer Order`,
+    fields: transferOrderFields,
+    initialData: {},
+    follow: true,
+    modelType: ModelType.transferorder
+  });
+
+  const tableActions = useMemo(() => {
+    return [
+      <AddItemButton
+        key='add-transfer-order'
+        tooltip={t`Add Transfer Order`}
+        onClick={() => newTransferOrder.open()}
+        hidden={!user.hasAddRole(UserRoles.transfer_order)}
+      />
+    ];
+  }, [user]);
+
+  return (
+    <>
+      {newTransferOrder.modal}
+      <InvenTreeTable
+        url={apiUrl(ApiEndpoints.transfer_order_list)}
+        tableState={table}
+        columns={tableColumns}
+        props={{
+          params: {
+            part: partId
+            // customer: customerId,
+            // customer_detail: true
+          },
+          tableFilters: tableFilters,
+          tableActions: tableActions,
+          modelType: ModelType.transferorder,
+          enableSelection: true,
+          enableDownload: true,
+          enableReports: true,
+          enableLabels: true
+        }}
+      />
+    </>
+  );
+}
diff --git a/src/frontend/tests/pages/pui_stock.spec.ts b/src/frontend/tests/pages/pui_stock.spec.ts
index 07d613debe..9f9c345eeb 100644
--- a/src/frontend/tests/pages/pui_stock.spec.ts
+++ b/src/frontend/tests/pages/pui_stock.spec.ts
@@ -1,8 +1,10 @@
 import { expect, test } from '../baseFixtures.js';
 import { stevenuser } from '../defaults.js';
 import {
+  activateCalendarView,
   clearTableFilters,
   clickButtonIfVisible,
+  clickOnRowMenu,
   loadTab,
   navigate,
   openFilterDrawer,
@@ -548,3 +550,209 @@ test('Stock - Location', async ({ browser }) => {
   await page.getByRole('button', { name: 'Scan', exact: true }).click();
   await page.getByText('No match found for barcode data').waitFor();
 });
+
+test('Transfer Orders - General', async ({ browser }) => {
+  const page = await doCachedLogin(browser);
+
+  await page.getByRole('tab', { name: 'Stock' }).click();
+  await page.waitForURL('**/stock/location/index/**');
+
+  await loadTab(page, 'Transfer Orders');
+
+  await clearTableFilters(page);
+
+  // We have now loaded the "Transfer Orders" table. Check for some expected texts
+  await page.getByText('Complete').first().waitFor();
+  await page.getByText('Issued').first().waitFor();
+  await page.getByText('Cancelled').first().waitFor();
+
+  // Load a particular Transfer Order
+  await page.getByRole('cell', { name: 'TO-0002' }).click();
+  await page.waitForTimeout(200);
+
+  // This transfer order should be "issued"
+  await page.getByText('Issued').first().waitFor();
+
+  // Edit the transfer order (via keyboard shortcut)
+  await page.keyboard.press('Control+E');
+  await page.getByLabel('text-field-reference', { exact: true }).waitFor();
+  await page.getByLabel('related-field-project_code').waitFor();
+  await page.getByRole('button', { name: 'Cancel' }).click();
+
+  await page.getByRole('button', { name: 'Complete Order' }).click();
+  await page.getByRole('button', { name: 'Cancel' }).click();
+
+  // Check for other expected actions
+  await page.getByRole('button', { name: 'action-menu-order-actions' }).click();
+  await page.getByLabel('action-menu-order-actions-edit').waitFor();
+  await page.getByLabel('action-menu-order-actions-duplicate').waitFor();
+  await page.getByLabel('action-menu-order-actions-hold').waitFor();
+
+  // Click on some tabs
+  await loadTab(page, 'Line Items');
+  await loadTab(page, 'Allocated Stock');
+  await loadTab(page, 'Parameters');
+  await loadTab(page, 'Attachments');
+  await loadTab(page, 'Notes');
+});
+
+test('Transfer Order - Reference', async ({ browser }) => {
+  const page = await doCachedLogin(browser);
+
+  // go to transfer orders
+  await page.getByRole('tab', { name: 'Stock' }).click();
+  await page.waitForURL('**/stock/location/index/**');
+  await loadTab(page, 'Transfer Orders');
+
+  // click add button
+  await page
+    .getByRole('button', { name: 'action-button-add-transfer-' })
+    .click();
+
+  // Ensure a new reference is suggested
+  await expect(
+    page.getByLabel('text-field-reference', { exact: true })
+  ).not.toBeEmpty();
+  // Grab the Transfer Order reference
+  const reference: string = await page
+    .getByRole('textbox', { name: 'text-field-reference' })
+    .inputValue();
+  expect(reference).toMatch(/TO-\d+/);
+
+  await page.getByRole('textbox', { name: 'text-field-description' }).click();
+  await page
+    .getByRole('textbox', { name: 'text-field-description' })
+    .fill('creating from playwrigh!');
+
+  // create the transfer order
+  await page.getByRole('button', { name: 'Submit' }).click();
+  await page.getByText('Item Created').waitFor();
+
+  // go back to stock page
+  await page.getByRole('link', { name: 'Stock', exact: true }).click();
+  await page
+    .getByRole('button', { name: 'action-button-add-transfer-' })
+    .click();
+
+  const nextReference: string = await page
+    .getByRole('textbox', { name: 'text-field-reference' })
+    .inputValue();
+  expect(nextReference).toMatch(/TO-\d+/);
+
+  // Ensure that the reference has incremented
+  const refNumber = Number(reference.replace('TO-', ''));
+  const nextRefNumber = Number(nextReference.replace('TO-', ''));
+  expect(nextRefNumber).toBe(refNumber + 1);
+});
+
+test('Transfer Order - Calendar', async ({ browser }) => {
+  const page = await doCachedLogin(browser);
+
+  await navigate(page, 'stock/location/index/transfer-orders');
+  await activateCalendarView(page);
+
+  // Export calendar data
+  await page.getByLabel('calendar-export-data').click();
+  await page.getByRole('button', { name: 'Export', exact: true }).click();
+  await page.getByText('Process completed successfully').waitFor();
+
+  // Required because we downloaded a file
+  await page.context().close();
+});
+
+test('Transfer Order - Edit', async ({ browser }) => {
+  const page = await doCachedLogin(browser);
+
+  await navigate(page, 'stock/transfer-order/2/');
+
+  // Check for expected text items
+  await page.getByText('Consume some paint').first().waitFor();
+  await page.getByText('2026-04-20').waitFor(); // Created date
+  await page.getByText('2026-04-23').waitFor(); // Issue date
+  await page.getByText('PRJ-HEL').waitFor(); // Project Code
+
+  await page.keyboard.press('Control+E');
+
+  // Edit start date
+  await page.getByLabel('date-field-start_date').fill('2026-04-28');
+
+  // Submit the form
+  await page.getByRole('button', { name: 'Submit' }).click();
+
+  // Expect error
+  await page.getByText('Errors exist for one or more form fields').waitFor();
+  await page.getByText('Target date must be after start date').waitFor();
+
+  // Cancel the form
+  await page.getByRole('button', { name: 'Cancel' }).click();
+});
+
+test('Transfer Order - Allocate and Transfer', async ({ browser }) => {
+  const page = await doCachedLogin(browser);
+
+  await navigate(page, 'stock/transfer-order/6/');
+
+  // Duplicate this transfer order, to ensure a fresh run each time
+  await page.getByLabel('action-menu-order-actions').click();
+  await page.getByLabel('action-menu-order-actions-duplicate').click();
+
+  // Submit the duplicate request and ensure it completes
+  await page.getByRole('button', { name: 'Submit' }).isEnabled();
+  await page.getByRole('button', { name: 'Submit' }).click();
+  await page.getByText('Item Created').waitFor();
+
+  // Issue the order
+  await page.getByRole('button', { name: 'Issue Order' }).click();
+  await page.getByRole('button', { name: 'Submit' }).click();
+  await page.getByText('Order issued').waitFor();
+
+  await loadTab(page, 'Line Items');
+
+  // Allocate line item 1
+  const cell1 = await page.getByText('C_100pF_0402', { exact: true });
+  await clickOnRowMenu(cell1);
+  await page.getByRole('menuitem', { name: 'Allocate Stock' }).click();
+  await page.getByText('C_100pF_0402Location:Offsite').waitFor();
+  await page.waitForTimeout(200);
+  await page.getByRole('button', { name: 'Submit' }).click();
+
+  // Allocate line item 1
+  const cell2 = await page.getByText('R_2.2K_0603_1%', { exact: true });
+  await clickOnRowMenu(cell2);
+  await page.getByRole('menuitem', { name: 'Allocate Stock' }).click();
+  await page.getByText('R_2.2K_0603_1%Location:').waitFor();
+  await page.waitForTimeout(200);
+  await page.getByRole('button', { name: 'Submit' }).click();
+
+  // Complete the order
+  await page.getByRole('button', { name: 'Complete Order' }).click();
+  await page.getByRole('button', { name: 'Submit' }).click();
+  await page.getByText('Complete', { exact: true }).first().waitFor();
+
+  // Tab should have changed to Transferred Stock
+  await loadTab(page, 'Transferred Stock');
+  await page.getByText('C_100pF_0402').waitFor();
+  await page.getByText('2.2K resistor in 0603 SMD').waitFor();
+});
+
+test('Transfer Orders - Duplicate', async ({ browser }) => {
+  const page = await doCachedLogin(browser, {
+    url: 'stock/transfer-order/1/detail'
+  });
+
+  await page.getByLabel('action-menu-order-actions').click();
+  await page.getByLabel('action-menu-order-actions-duplicate').click();
+
+  // Ensure a new reference is suggested
+  await expect(
+    page.getByLabel('text-field-reference', { exact: true })
+  ).not.toBeEmpty();
+
+  // Submit the duplicate request and ensure it completes
+  await page.getByRole('button', { name: 'Submit' }).isEnabled();
+  await page.getByRole('button', { name: 'Submit' }).click();
+  await page.getByRole('tab', { name: 'Order Details' }).waitFor();
+  await page.getByRole('tab', { name: 'Order Details' }).click();
+
+  await page.getByText('Pending').first().waitFor();
+});

From 27ca0836e7c7e46ebb41ea98d507972ae7a6b018 Mon Sep 17 00:00:00 2001
From: Oliver <oliver.henry.walters@gmail.com>
Date: Fri, 22 May 2026 23:37:32 +1000
Subject: [PATCH 10/10] [refactor] Attachment images (#11961)

* Add new Attachment model fields:

- is_image
- thumbnail

* Cache if the attachment is an image

* Add new setting for controlling max upload size

* Validate uploaded attachment file

* Add tqdm for progress bars

* Refactor migrations

- Don't need is_image field
- Can introspect from the thumbnail

* Data migration for existing attachments

* Bump API version

* Update tests and validators

* Add "is_image" field to the Attachment model

* Offload to background task

* Implement unit tests

* Docs

* Add unit test for data migration

* Additional unit test

* Omit migration tests from code coverage

* Additional unit tests
---
 codecov.yml                                   |   3 +
 docs/docs/concepts/attachments.md             |  13 ++
 docs/docs/settings/global.md                  |   1 +
 pyproject.toml                                |   1 +
 .../InvenTree/InvenTree/api_version.py        |   5 +-
 src/backend/InvenTree/common/api.py           |  12 +-
 ...ttachment_is_image_attachment_thumbnail.py |  48 ++++
 .../migrations/0043_auto_20260518_1206.py     |  58 +++++
 src/backend/InvenTree/common/models.py        | 103 ++++++++-
 src/backend/InvenTree/common/serializers.py   |  13 +-
 .../InvenTree/common/setting/system.py        |   7 +
 src/backend/InvenTree/common/tasks.py         |  18 ++
 src/backend/InvenTree/common/test_api.py      | 210 ++++++++++++++++++
 .../InvenTree/common/test_migrations.py       |  81 +++++++
 src/backend/InvenTree/common/tests.py         |   6 +-
 src/backend/InvenTree/common/validators.py    |  18 +-
 src/backend/requirements-3.14.txt             |   6 +
 src/backend/requirements.in                   |   1 +
 src/backend/requirements.txt                  |   4 +
 .../src/components/items/AttachmentLink.tsx   |  11 +-
 .../pages/Index/Settings/SystemSettings.tsx   |   1 +
 .../src/tables/general/AttachmentTable.tsx    |  12 +-
 22 files changed, 624 insertions(+), 8 deletions(-)
 create mode 100644 src/backend/InvenTree/common/migrations/0042_attachment_is_image_attachment_thumbnail.py
 create mode 100644 src/backend/InvenTree/common/migrations/0043_auto_20260518_1206.py

diff --git a/codecov.yml b/codecov.yml
index b06601b57b..b49179c3ed 100644
--- a/codecov.yml
+++ b/codecov.yml
@@ -1,3 +1,6 @@
+ignore:
+  - "src/backend/InvenTree/**/test_migrations.py"
+
 coverage:
   status:
     project:
diff --git a/docs/docs/concepts/attachments.md b/docs/docs/concepts/attachments.md
index 55f42736f0..b376cace6d 100644
--- a/docs/docs/concepts/attachments.md
+++ b/docs/docs/concepts/attachments.md
@@ -25,6 +25,19 @@ The following types of attachments are supported:
 
 File attachments allow users to upload files directly to InvenTree. These files are stored on the server and can be downloaded or viewed by users with appropriate permissions.
 
+### Image Thumbnails
+
+When a file attachment is uploaded, InvenTree automatically determines whether the file is a valid image. If it is, a thumbnail is generated and stored alongside the attachment.
+
+- The thumbnail is created with a reduced image size, while preserving the original aspect ratio.
+- Thumbnail generation is performed in the background after upload.
+- The `is_image` flag on the attachment record is set to `True` for valid images, and `False` for all other file types.
+- If the uploaded file has an image extension but contains invalid or corrupt image data, no thumbnail is generated and `is_image` remains `False`.
+- Link attachments (external URLs) are never assigned a thumbnail.
+
+!!! info "Supported Formats"
+    Any image format recognised by the [Pillow](https://pillow.readthedocs.io/) library (e.g. PNG, JPEG, GIF, BMP, WEBP) will be treated as a valid image and have a thumbnail generated automatically.
+
 ### Link Attachments
 
 Link attachments allow users to associate external URLs with an object. This can be useful for linking to external documentation, resources, or other relevant web content.
diff --git a/docs/docs/settings/global.md b/docs/docs/settings/global.md
index d5f33061cb..4ae4d02f40 100644
--- a/docs/docs/settings/global.md
+++ b/docs/docs/settings/global.md
@@ -33,6 +33,7 @@ Configuration of basic server settings:
 {{ globalsetting("DISPLAY_FULL_NAMES") }}
 {{ globalsetting("DISPLAY_PROFILE_INFO") }}
 {{ globalsetting("WEEK_STARTS_ON") }}
+{{ globalsetting("INVENTREE_UPLOAD_MAX_SIZE") }}
 {{ globalsetting("INVENTREE_STRICT_URLS") }}
 
 Configuration of various scheduled tasks:
diff --git a/pyproject.toml b/pyproject.toml
index 63a0fd5a6e..169e5a1f89 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -120,6 +120,7 @@ possibly-unbound-attribute="ignore"  # 21
 [tool.coverage.run]
 source = ["src/backend/InvenTree", "InvenTree"]
 dynamic_context = "test_function"
+omit = ["*/test_migrations.py"]
 
 [tool.coverage.html]
 show_contexts = true
diff --git a/src/backend/InvenTree/InvenTree/api_version.py b/src/backend/InvenTree/InvenTree/api_version.py
index 64b1ffdf46..de8640d308 100644
--- a/src/backend/InvenTree/InvenTree/api_version.py
+++ b/src/backend/InvenTree/InvenTree/api_version.py
@@ -1,11 +1,14 @@
 """InvenTree API version information."""
 
 # InvenTree API version
-INVENTREE_API_VERSION = 492
+INVENTREE_API_VERSION = 493
 """Increment this API version number whenever there is a significant change to the API that any clients need to know about."""
 
 INVENTREE_API_TEXT = """
 
+v493 -> 2026-05-18 : https://github.com/inventree/InvenTree/pull/11961
+    - Adds "thumbnail" field to the Attachment API endpoint, which provides a URL to a thumbnail image for image attachments (if available)
+
 v492 -> 2026-05-22 : https://github.com/inventree/InvenTree/pull/11281
     - Add Transfer Order model and associated API endpoint
 
diff --git a/src/backend/InvenTree/common/api.py b/src/backend/InvenTree/common/api.py
index 05575f73a8..5726b32f91 100644
--- a/src/backend/InvenTree/common/api.py
+++ b/src/backend/InvenTree/common/api.py
@@ -717,7 +717,17 @@ class AttachmentFilter(FilterSet):
         """Metaclass options."""
 
         model = common.models.Attachment
-        fields = ['model_type', 'model_id', 'upload_user']
+        fields = ['model_type', 'model_id', 'upload_user', 'is_image']
+
+    has_thumbnail = rest_filters.BooleanFilter(
+        label=_('Has Thumbnail'), method='filter_has_thumbnail'
+    )
+
+    def filter_has_thumbnail(self, queryset, name, value):
+        """Filter attachments based on whether they have a thumbnail or not."""
+        if value:
+            return queryset.exclude(thumbnail=None).exclude(thumbnail='')
+        return queryset.filter(Q(thumbnail=None) | Q(thumbnail='')).distinct()
 
     is_link = rest_filters.BooleanFilter(label=_('Is Link'), method='filter_is_link')
 
diff --git a/src/backend/InvenTree/common/migrations/0042_attachment_is_image_attachment_thumbnail.py b/src/backend/InvenTree/common/migrations/0042_attachment_is_image_attachment_thumbnail.py
new file mode 100644
index 0000000000..d4bf86df20
--- /dev/null
+++ b/src/backend/InvenTree/common/migrations/0042_attachment_is_image_attachment_thumbnail.py
@@ -0,0 +1,48 @@
+# Generated by Django 5.2.14 on 2026-05-18 11:34
+
+from django.db import migrations, models
+
+import common.models
+import common.validators
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ("common", "0041_auto_20251203_1244"),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name="attachment",
+            name="thumbnail",
+            field=models.ImageField(
+                blank=True,
+                help_text="Thumbnail image for this attachment",
+                null=True,
+                upload_to="",
+                verbose_name="Thumbnail",
+            ),
+        ),
+        migrations.AddField(
+            model_name="attachment",
+            name="is_image",
+            field=models.BooleanField(
+                default=False,
+                help_text="True if this attachment is a valid image file",
+                verbose_name="Is image",
+            ),
+        ),
+        migrations.AlterField(
+            model_name="attachment",
+            name="attachment",
+            field=models.FileField(
+                blank=True,
+                help_text="Select file to attach",
+                null=True,
+                upload_to=common.models.rename_attachment,
+                validators=[common.validators.validate_attachment_file],
+                verbose_name="Attachment",
+            ),
+        ),
+    ]
diff --git a/src/backend/InvenTree/common/migrations/0043_auto_20260518_1206.py b/src/backend/InvenTree/common/migrations/0043_auto_20260518_1206.py
new file mode 100644
index 0000000000..597ad45cf7
--- /dev/null
+++ b/src/backend/InvenTree/common/migrations/0043_auto_20260518_1206.py
@@ -0,0 +1,58 @@
+# Generated by Django 5.2.14 on 2026-05-18 12:06
+
+import io
+import os
+
+from PIL import Image
+from tqdm import tqdm
+
+from time import sleep
+
+from django.db import migrations
+from django.core.files.base import ContentFile
+from django.core.files.storage import default_storage
+
+
+def update_image_attachments(apps, schema_editor):
+    """Update existing attachments to ensure that image attachments have thumbnails.
+    
+    For each existing attachment, check if it is an image.
+    If it is, generate a thumbnail for it.
+
+    Note: This function mirrors the logic used in the Attachment model's
+    check_is_image method, at the time of writing this migration (2026-05-18).
+    """
+
+    import common.tasks
+
+    Attachment = apps.get_model('common', 'Attachment')
+
+    # Find all Attachment instances which (potentially) have a file attached
+    attachments = Attachment.objects.exclude(attachment__isnull=True).exclude(attachment='')
+
+    if attachments.count() == 0:
+        return
+
+    progress = tqdm(total=attachments.count(), desc='Migration common.0043: Updating attachments')
+
+    for attachment in attachments:
+        progress.update(1)
+        
+        if not attachment.attachment:
+            continue
+        
+        if not attachment.attachment.name or not default_storage.exists(attachment.attachment.name):
+            continue
+
+        common.tasks.rebuild_attachment(attachment.pk)
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ("common", "0042_attachment_is_image_attachment_thumbnail"),
+    ]
+
+    operations = [
+        migrations.RunPython(update_image_attachments, reverse_code=migrations.RunPython.noop),
+    ]
diff --git a/src/backend/InvenTree/common/models.py b/src/backend/InvenTree/common/models.py
index 72a7866568..a53d2640b4 100644
--- a/src/backend/InvenTree/common/models.py
+++ b/src/backend/InvenTree/common/models.py
@@ -48,6 +48,7 @@ from django_q.signals import post_spawn
 from djmoney.contrib.exchange.exceptions import MissingRate
 from djmoney.contrib.exchange.models import convert_money
 from opentelemetry import trace
+from PIL import Image
 from rest_framework.exceptions import PermissionDenied
 from taggit.managers import TaggableManager
 
@@ -1932,6 +1933,8 @@ class Attachment(InvenTree.models.MetadataMixin, InvenTree.models.InvenTreeModel
         model_id: The ID of the model to which this attachment is linked
         attachment: The uploaded file
         url: An external URL
+        thumbnail: A generated thumbnail for the uploaded file (if applicable)
+        is_image: True if this attachment is a valid image file
         comment: A comment or description for the attachment
         user: The user who uploaded the attachment
         upload_date: The date the attachment was uploaded
@@ -1940,6 +1943,8 @@ class Attachment(InvenTree.models.MetadataMixin, InvenTree.models.InvenTreeModel
         tags: Tags for the attachment
     """
 
+    THUMBNAIL_SIZE = 256
+
     class Meta:
         """Metaclass options."""
 
@@ -1956,9 +1961,11 @@ class Attachment(InvenTree.models.MetadataMixin, InvenTree.models.InvenTreeModel
         - Ensure that the attached file is deleted from storage when the database entry is removed
         """
         attachment = self.attachment
+        thumbnail = self.thumbnail
 
         super().delete(*args, **kwargs)
 
+        # Delete the associated files from storage (if they exist)W
         if attachment and default_storage.exists(attachment.name):
             try:
                 # Remove the attached file from storage
@@ -1966,6 +1973,13 @@ class Attachment(InvenTree.models.MetadataMixin, InvenTree.models.InvenTreeModel
             except Exception:  # pragma: no cover
                 pass
 
+        if thumbnail and default_storage.exists(thumbnail.name):
+            try:
+                # Remove the thumbnail file from storage
+                default_storage.delete(thumbnail.name)
+            except Exception:  # pragma: no cover
+                pass
+
     def save(self, *args, **kwargs):
         """Custom 'save' method for the Attachment model.
 
@@ -1973,6 +1987,10 @@ class Attachment(InvenTree.models.MetadataMixin, InvenTree.models.InvenTreeModel
         - Ensure that the 'content_type' and 'object_id' fields are set
         - Run extra validations
         """
+        import common.tasks
+
+        rebuild = kwargs.pop('rebuild', True)
+
         # Either 'attachment' or 'link' must be specified!
         if not self.attachment and not self.link:
             raise ValidationError({
@@ -2000,6 +2018,12 @@ class Attachment(InvenTree.models.MetadataMixin, InvenTree.models.InvenTreeModel
             if self.file_size != 0:
                 super().save()
 
+        # Offload a background task to update the thumbnail for this attachment
+        if rebuild:
+            InvenTree.tasks.offload_task(
+                common.tasks.rebuild_attachment, self.pk, group='attachments'
+            )
+
     def clean_svg(self, field):
         """Sanitize SVG file before saving."""
         cleaned = sanitize_svg(field.file.read())
@@ -2077,11 +2101,19 @@ class Attachment(InvenTree.models.MetadataMixin, InvenTree.models.InvenTreeModel
     attachment = models.FileField(
         upload_to=rename_attachment,
         verbose_name=_('Attachment'),
+        validators=[common.validators.validate_attachment_file],
         help_text=_('Select file to attach'),
         blank=True,
         null=True,
     )
 
+    thumbnail = models.ImageField(
+        verbose_name=_('Thumbnail'),
+        help_text=_('Thumbnail image for this attachment'),
+        blank=True,
+        null=True,
+    )
+
     link = InvenTree.fields.InvenTreeURLField(
         blank=True,
         null=True,
@@ -2114,6 +2146,12 @@ class Attachment(InvenTree.models.MetadataMixin, InvenTree.models.InvenTreeModel
         help_text=_('Date the file was uploaded'),
     )
 
+    is_image = models.BooleanField(
+        default=False,
+        verbose_name=_('Is image'),
+        help_text=_('True if this attachment is a valid image file'),
+    )
+
     file_size = models.PositiveIntegerField(
         default=0, verbose_name=_('File size'), help_text=_('File size in bytes')
     )
@@ -2157,6 +2195,69 @@ class Attachment(InvenTree.models.MetadataMixin, InvenTree.models.InvenTreeModel
 
         return model_class.check_related_permission(permission, user)
 
+    def check_is_image(self) -> bool:
+        """Check if the attached file is an image.
+
+        We consider it a valid image if:
+
+        - The file exists in storage
+        - The file can be opened and verified by the PIL library
+
+        """
+        if not self.attachment:
+            return False
+
+        if not self.attachment.name:
+            return False
+
+        try:
+            if not default_storage.exists(self.attachment.name):
+                return False
+        except Exception:
+            return False
+
+        img_data = default_storage.open(self.attachment.name).read()
+
+        try:
+            Image.open(BytesIO(img_data)).verify()
+            return True
+        except Exception:
+            return False
+
+    def generate_thumbnail(self):
+        """Generate a thumbnail for the attached image."""
+        # Remove any existing thumbnail
+        if self.thumbnail:
+            self.thumbnail.delete(save=False)
+
+        if not self.attachment:
+            return
+
+        if not self.attachment.name or not default_storage.exists(self.attachment.name):
+            return
+
+        # TODO: Offload to plugins, for creating custom thumbnails for different file types
+        # TODO: If a plugin provides a thumbnail, return early
+
+        # Default action is to generate a thumbnail for image files
+        try:
+            img_data = default_storage.open(self.attachment.name).read()
+        except Exception:
+            # No file found, or file cannot be read - cannot generate thumbnail
+            return
+
+        try:
+            img = Image.open(BytesIO(img_data))
+            img.thumbnail((self.THUMBNAIL_SIZE, self.THUMBNAIL_SIZE))
+            thumb_io = BytesIO()
+            img.save(thumb_io, format='PNG')
+            thumb_io.seek(0)
+
+            thumb_name = f'thumb_{os.path.basename(self.attachment.name)}'
+            self.thumbnail.save(thumb_name, ContentFile(thumb_io.read()), save=False)
+        except Exception:
+            pass
+
 
 class InvenTreeCustomUserStateModel(models.Model):
     """Custom model to extends any registered state with extra custom, user defined states.
@@ -2684,7 +2785,7 @@ def post_save_parameter_template(sender, instance, created, **kwargs):
                 common.tasks.rebuild_parameters,
                 instance.pk,
                 force_async=True,
-                group='part',
+                group='parameters',
             )
 
 
diff --git a/src/backend/InvenTree/common/serializers.py b/src/backend/InvenTree/common/serializers.py
index 025c28f6d0..c8e2f13920 100644
--- a/src/backend/InvenTree/common/serializers.py
+++ b/src/backend/InvenTree/common/serializers.py
@@ -730,9 +730,11 @@ class AttachmentSerializer(FilterableSerializerMixin, InvenTreeModelSerializer):
         fields = [
             'pk',
             'attachment',
+            'thumbnail',
             'filename',
             'link',
             'comment',
+            'is_image',
             'upload_date',
             'upload_user',
             'user_detail',
@@ -742,7 +744,14 @@ class AttachmentSerializer(FilterableSerializerMixin, InvenTreeModelSerializer):
             'tags',
         ]
 
-        read_only_fields = ['pk', 'file_size', 'upload_date', 'upload_user', 'filename']
+        read_only_fields = [
+            'pk',
+            'file_size',
+            'upload_date',
+            'upload_user',
+            'filename',
+            'is_image',
+        ]
 
     def __init__(self, *args, **kwargs):
         """Override the model_type field to provide dynamic choices."""
@@ -759,6 +768,8 @@ class AttachmentSerializer(FilterableSerializerMixin, InvenTreeModelSerializer):
 
     attachment = InvenTreeAttachmentSerializerField(required=False, allow_null=True)
 
+    thumbnail = InvenTreeImageSerializerField(read_only=True, allow_null=True)
+
     # The 'filename' field must be present in the serializer
     filename = serializers.CharField(
         label=_('Filename'), required=False, source='basename', allow_blank=False
diff --git a/src/backend/InvenTree/common/setting/system.py b/src/backend/InvenTree/common/setting/system.py
index 456d7de095..0f1283be06 100644
--- a/src/backend/InvenTree/common/setting/system.py
+++ b/src/backend/InvenTree/common/setting/system.py
@@ -286,6 +286,13 @@ SYSTEM_SETTINGS: dict[str, InvenTreeSettingsKeyType] = {
         'choices': common.currency.currency_exchange_plugins,
         'default': 'inventreecurrencyexchange',
     },
+    'INVENTREE_UPLOAD_MAX_SIZE': {
+        'name': _('Upload Size Limit'),
+        'description': _('Maximum allowable upload size for images and files'),
+        'units': 'MB',
+        'default': 10,
+        'validator': [int, MinValueValidator(1)],
+    },
     'INVENTREE_STRICT_URLS': {
         'name': _('Strict URL Validation'),
         'description': _('Require schema specification when validating URLs'),
diff --git a/src/backend/InvenTree/common/tasks.py b/src/backend/InvenTree/common/tasks.py
index 6a86367937..43afef5245 100644
--- a/src/backend/InvenTree/common/tasks.py
+++ b/src/backend/InvenTree/common/tasks.py
@@ -204,3 +204,21 @@ def rebuild_parameters(template_id):
 
     if n > 0:
         logger.info("Rebuilt %s parameters for template '%s'", n, template.name)
+
+
+@tracer.start_as_current_span('rebuild_attachment')
+def rebuild_attachment(attachment_id: int):
+    """Rebuild the given attachment, if possible.
+
+    This task is called whenever an attachment is saved, and perform the following tasks:
+
+    - Check if the attachment is an image file, and update the "is_image" field accordingly
+    - Attempt to generate a thumbnail for the attachment
+    """
+    from common.models import Attachment
+
+    attachment = Attachment.objects.get(pk=attachment_id)
+
+    attachment.is_image = attachment.check_is_image()
+    attachment.generate_thumbnail()
+    attachment.save(rebuild=False)
diff --git a/src/backend/InvenTree/common/test_api.py b/src/backend/InvenTree/common/test_api.py
index febbf5622e..d4875c9014 100644
--- a/src/backend/InvenTree/common/test_api.py
+++ b/src/backend/InvenTree/common/test_api.py
@@ -4,8 +4,11 @@ import io
 
 from django.core.files.base import ContentFile
 from django.core.files.storage import default_storage
+from django.core.files.uploadedfile import SimpleUploadedFile
 from django.urls import reverse
 
+from PIL import Image
+
 import common.models
 from InvenTree.unit_test import InvenTreeAPITestCase
 
@@ -789,3 +792,210 @@ class AttachmentAPITests(InvenTreeAPITestCase):
         for att in attachments:
             # Ensure that the file associated with each attachment has been removed
             self.assertFalse(default_storage.exists(att.attachment.path))
+
+
+class AttachmentThumbnailAPITests(InvenTreeAPITestCase):
+    """Tests for thumbnail generation when uploading attachments via the API."""
+
+    def setUp(self):
+        """Set up a Part instance and required roles."""
+        from part.models import Part
+
+        super().setUp()
+        self.assignRole('part.add')
+        self.assignRole('part.delete')
+        self.part = Part.objects.create(
+            name='Thumbnail Test Part', description='Part for thumbnail testing'
+        )
+
+    def _make_image_file(self, name='test.png', size=(100, 100), color='red'):
+        """Return a SimpleUploadedFile containing a valid PNG image."""
+        buf = io.BytesIO()
+        Image.new('RGB', size, color=color).save(buf, format='PNG')
+        return SimpleUploadedFile(name, buf.getvalue(), content_type='image/png')
+
+    def _upload_attachment(self, file_obj, expected_code=201):
+        """Upload a file attachment against the test part and return the response."""
+        return self.post(
+            reverse('api-attachment-list'),
+            data={
+                'model_type': 'part',
+                'model_id': self.part.pk,
+                'attachment': file_obj,
+            },
+            format='multipart',
+            expected_code=expected_code,
+        )
+
+    def test_thumbnail_valid_image(self):
+        """Uploading a valid image file should set is_image=True and generate a thumbnail."""
+        from common.models import Attachment
+
+        response = self._upload_attachment(self._make_image_file())
+        att = Attachment.objects.get(pk=response.data['pk'])
+
+        self.assertTrue(att.is_image)
+        self.assertTrue(att.thumbnail)
+        self.assertTrue(default_storage.exists(att.thumbnail.name))
+
+    def test_thumbnail_invalid_image(self):
+        """Uploading a file with an image extension but invalid image data should not create a thumbnail."""
+        from common.models import Attachment
+
+        bad_file = SimpleUploadedFile(
+            'corrupt.png', b'this is not image data', content_type='image/png'
+        )
+        response = self._upload_attachment(bad_file)
+        att = Attachment.objects.get(pk=response.data['pk'])
+
+        self.assertFalse(att.is_image)
+        self.assertFalse(att.thumbnail)
+
+    def test_thumbnail_non_image_file(self):
+        """Uploading a non-image file should leave is_image=False with no thumbnail."""
+        from common.models import Attachment
+
+        txt_file = SimpleUploadedFile(
+            'document.txt', b'Hello, InvenTree!', content_type='text/plain'
+        )
+        response = self._upload_attachment(txt_file)
+        att = Attachment.objects.get(pk=response.data['pk'])
+
+        self.assertFalse(att.is_image)
+        self.assertFalse(att.thumbnail)
+
+    def test_thumbnail_large_image(self):
+        """A large image attachment should produce a thumbnail no larger than THUMBNAIL_SIZE on each side."""
+        from common.models import Attachment
+
+        response = self._upload_attachment(self._make_image_file(size=(1000, 1000)))
+        att = Attachment.objects.get(pk=response.data['pk'])
+
+        self.assertTrue(att.is_image)
+        self.assertTrue(att.thumbnail)
+
+        thumb_data = default_storage.open(att.thumbnail.name).read()
+        thumb_img = Image.open(io.BytesIO(thumb_data))
+        self.assertLessEqual(thumb_img.width, Attachment.THUMBNAIL_SIZE)
+        self.assertLessEqual(thumb_img.height, Attachment.THUMBNAIL_SIZE)
+
+    def test_thumbnail_deleted_with_attachment(self):
+        """Deleting an attachment via the API should also remove its thumbnail from storage."""
+        from common.models import Attachment
+
+        response = self._upload_attachment(self._make_image_file())
+        att = Attachment.objects.get(pk=response.data['pk'])
+
+        self.assertTrue(att.thumbnail)
+        thumb_name = att.thumbnail.name
+        att_name = att.attachment.name
+
+        self.assertTrue(default_storage.exists(att_name))
+        self.assertTrue(default_storage.exists(thumb_name))
+
+        self.delete(
+            reverse('api-attachment-detail', kwargs={'pk': att.pk}), expected_code=204
+        )
+
+        self.assertFalse(default_storage.exists(att_name))
+        self.assertFalse(default_storage.exists(thumb_name))
+
+    def test_thumbnail_zero_byte_file(self):
+        """Uploading a zero-byte file should be rejected by Django's file validation before reaching thumbnail logic."""
+        empty_file = SimpleUploadedFile('empty.png', b'', content_type='image/png')
+        # Django's FileField rejects empty uploads at the serializer/validation layer
+        response = self._upload_attachment(empty_file, expected_code=400)
+        self.assertIn('attachment', response.data)
+
+    def test_thumbnail_link_attachment(self):
+        """An attachment created with an external link (no file) should not generate a thumbnail."""
+        from common.models import Attachment
+
+        response = self.post(
+            reverse('api-attachment-list'),
+            data={
+                'model_type': 'part',
+                'model_id': self.part.pk,
+                'link': 'https://example.com/some/resource',
+            },
+            format='multipart',
+            expected_code=201,
+        )
+
+        att = Attachment.objects.get(pk=response.data['pk'])
+
+        self.assertFalse(att.is_image)
+        self.assertFalse(att.thumbnail)
+
+    def test_is_image_filter(self):
+        """The is_image filter on the attachment list endpoint should return only matching attachments."""
+        url = reverse('api-attachment-list')
+        base_filters = {'model_type': 'part', 'model_id': self.part.pk}
+
+        # Upload one valid image and three non-image attachments
+        self._upload_attachment(self._make_image_file('img1.png'))
+        self._upload_attachment(
+            SimpleUploadedFile(
+                'corrupt.png', b'not image data', content_type='image/png'
+            )
+        )
+        self._upload_attachment(
+            SimpleUploadedFile('doc.txt', b'hello', content_type='text/plain')
+        )
+        self.post(
+            url,
+            data={**base_filters, 'link': 'https://example.com/resource'},
+            format='multipart',
+            expected_code=201,
+        )
+
+        all_attachments = self.get(url, base_filters, expected_code=200).data
+        self.assertEqual(len(all_attachments), 4)
+
+        # is_image=true → only the valid image
+        images = self.get(
+            url, {**base_filters, 'is_image': 'true'}, expected_code=200
+        ).data
+        self.assertEqual(len(images), 1)
+        self.assertTrue(images[0]['is_image'])
+
+        # is_image=false → the three non-image attachments
+        non_images = self.get(
+            url, {**base_filters, 'is_image': 'false'}, expected_code=200
+        ).data
+        self.assertEqual(len(non_images), 3)
+        self.assertTrue(all(not a['is_image'] for a in non_images))
+
+    def test_upload_exceeds_size_limit(self):
+        """Uploading a file that exceeds INVENTREE_UPLOAD_MAX_SIZE should be rejected with a 400 error."""
+        from common.settings import get_global_setting, set_global_setting
+
+        original_limit = get_global_setting('INVENTREE_UPLOAD_MAX_SIZE')
+        # Use a 1 MB ceiling so the test file stays small and fast
+        set_global_setting('INVENTREE_UPLOAD_MAX_SIZE', 1, change_user=None)
+
+        limit_bytes = 1 * 1024 * 1024
+
+        try:
+            # File exactly at the limit — validator uses >, so this must be accepted
+            self._upload_attachment(
+                SimpleUploadedFile(
+                    'at_limit.txt', b'\x00' * limit_bytes, content_type='text/plain'
+                ),
+                expected_code=201,
+            )
+
+            # File one byte over the limit — must be rejected
+            response = self._upload_attachment(
+                SimpleUploadedFile(
+                    'over_limit.txt',
+                    b'\x00' * (limit_bytes + 1),
+                    content_type='text/plain',
+                ),
+                expected_code=400,
+            )
+            self.assertIn('attachment', response.data)
+        finally:
+            set_global_setting(
+                'INVENTREE_UPLOAD_MAX_SIZE', original_limit, change_user=None
+            )
diff --git a/src/backend/InvenTree/common/test_migrations.py b/src/backend/InvenTree/common/test_migrations.py
index 6c21dc1074..c6e62cefef 100644
--- a/src/backend/InvenTree/common/test_migrations.py
+++ b/src/backend/InvenTree/common/test_migrations.py
@@ -4,8 +4,10 @@ import io
 import os
 
 from django.core.files.base import ContentFile
+from django.core.files.storage import default_storage
 
 from django_test_migrations.contrib.unittest_case import MigratorTestCase
+from PIL import Image
 
 
 def get_legacy_models():
@@ -209,6 +211,85 @@ class TestForwardMigrations(MigratorTestCase):
             self.assertEqual(Attachment.objects.filter(model_type=model).count(), 2)
 
 
+class TestAttachmentThumbnailMigration(MigratorTestCase):
+    """Test that migration 0043 correctly populates is_image and generates thumbnails for existing attachments."""
+
+    migrate_from = ('common', '0041_auto_20251203_1244')
+    migrate_to = ('common', '0043_auto_20260518_1206')
+
+    def prepare(self):
+        """Create a set of attachments with different file types in the pre-migration state.
+
+        At this point the Attachment model has no is_image or thumbnail fields yet.
+        Files are written to storage directly through the FileField so that the
+        data migration can find them at their stored paths.
+        """
+        Attachment = self.old_state.apps.get_model('common', 'Attachment')
+
+        # 1. Valid PNG image — migration should set is_image=True and create a thumbnail
+        buf = io.BytesIO()
+        Image.new('RGB', (100, 100), color='blue').save(buf, format='PNG')
+        Attachment.objects.create(
+            model_type='part',
+            model_id=1,
+            attachment=ContentFile(buf.getvalue(), name='valid_image.png'),
+            comment='valid_image',
+        )
+
+        # 2. File with a .png extension but non-image content — migration should leave is_image=False
+        Attachment.objects.create(
+            model_type='part',
+            model_id=1,
+            attachment=ContentFile(b'this is not image data', name='corrupt.png'),
+            comment='corrupt_image',
+        )
+
+        # 3. Plain text file — migration should leave is_image=False with no thumbnail
+        Attachment.objects.create(
+            model_type='part',
+            model_id=1,
+            attachment=ContentFile(b'Hello, InvenTree!', name='document.txt'),
+            comment='text_file',
+        )
+
+        # 4. Link attachment (no file at all) — migration should skip it entirely
+        Attachment.objects.create(
+            model_type='part',
+            model_id=1,
+            link='https://example.com/resource',
+            comment='link_attachment',
+        )
+
+        self.assertEqual(Attachment.objects.count(), 4)
+
+    def test_attachment_thumbnails_after_migration(self):
+        """After applying migrations 0042 and 0043, verify is_image and thumbnail are correct."""
+        Attachment = self.new_state.apps.get_model('common', 'Attachment')
+
+        self.assertEqual(Attachment.objects.count(), 4)
+
+        # Valid image → is_image set, thumbnail file created in storage
+        att = Attachment.objects.get(comment='valid_image')
+        self.assertTrue(att.is_image)
+        self.assertTrue(att.thumbnail)
+        self.assertTrue(default_storage.exists(att.thumbnail.name))
+
+        # Corrupt image → is_image not set, no thumbnail
+        att = Attachment.objects.get(comment='corrupt_image')
+        self.assertFalse(att.is_image)
+        self.assertFalse(att.thumbnail)
+
+        # Text file → is_image not set, no thumbnail
+        att = Attachment.objects.get(comment='text_file')
+        self.assertFalse(att.is_image)
+        self.assertFalse(att.thumbnail)
+
+        # Link attachment → is_image not set, no thumbnail
+        att = Attachment.objects.get(comment='link_attachment')
+        self.assertFalse(att.is_image)
+        self.assertFalse(att.thumbnail)
+
+
 def prep_currency_migration(self, vals: str):
     """Prepare the environment for the currency migration tests."""
     # Set keys
diff --git a/src/backend/InvenTree/common/tests.py b/src/backend/InvenTree/common/tests.py
index 21a9474328..af0420e62d 100644
--- a/src/backend/InvenTree/common/tests.py
+++ b/src/backend/InvenTree/common/tests.py
@@ -86,6 +86,11 @@ class AttachmentTest(InvenTreeAPITestCase):
         }
 
         for fn, expected in filenames.items():
+            expected_path = f'attachments/part/{part.pk}/{expected}'
+            # Remove the file if it already exists (i.e. from a previous test run)
+            if default_storage.exists(expected_path):
+                default_storage.delete(expected_path)
+
             attachment = Attachment.objects.create(
                 attachment=self.generate_file(fn),
                 comment=f'Testing filename: {fn}',
@@ -93,7 +98,6 @@ class AttachmentTest(InvenTreeAPITestCase):
                 model_id=part.pk,
             )
 
-            expected_path = f'attachments/part/{part.pk}/{expected}'
             self.assertEqual(attachment.attachment.name, expected_path)
             self.assertEqual(attachment.file_size, 15)
 
diff --git a/src/backend/InvenTree/common/validators.py b/src/backend/InvenTree/common/validators.py
index 02c3805f96..226a42b7d2 100644
--- a/src/backend/InvenTree/common/validators.py
+++ b/src/backend/InvenTree/common/validators.py
@@ -2,7 +2,8 @@
 
 import re
 
-from django.core.exceptions import ValidationError
+from django.core.exceptions import SuspiciousFileOperation, ValidationError
+from django.core.files.storage import default_storage
 from django.utils.translation import gettext_lazy as _
 
 import common.icons
@@ -76,6 +77,21 @@ def validate_attachment_model_type(value):
         raise ValidationError('Model type does not support attachments')
 
 
+def validate_attachment_file(attachment):
+    """Ensure that the provided attachment file is valid."""
+    max_size = get_global_setting('INVENTREE_UPLOAD_MAX_SIZE', create=False)
+
+    if attachment.size > (max_size * 1024 * 1024):
+        raise ValidationError(
+            _(f'File size exceeds maximum upload limit of {max_size} MB')
+        )
+
+    try:
+        default_storage.generate_filename(attachment.name)
+    except SuspiciousFileOperation:  # pragma: no cover
+        raise ValidationError(_('Invalid file name'))
+
+
 def validate_notes_model_type(value):
     """Ensure that the provided model type is valid.
 
diff --git a/src/backend/requirements-3.14.txt b/src/backend/requirements-3.14.txt
index 96528aea96..b396bc0fa9 100644
--- a/src/backend/requirements-3.14.txt
+++ b/src/backend/requirements-3.14.txt
@@ -2152,6 +2152,12 @@ tinyhtml5==2.1.0 \
     # via
     #   -c src/backend/requirements.txt
     #   weasyprint
+tqdm==4.67.3 \
+    --hash=sha256:7d825f03f89244ef73f1d4ce193cb1774a8179fd96f31d7e1dcde62092b960bb \
+    --hash=sha256:ee1e4c0e59148062281c49d80b25b67771a127c85fc9676d3be5f243206826bf
+    # via
+    #   -c src/backend/requirements.txt
+    #   -r src/backend/requirements.in
 typing-extensions==4.15.0 \
     --hash=sha256:0cea48d173cc12fa28ecabc3b837ea3cf6f38c6d1136f85cbaaf598984861466 \
     --hash=sha256:f0fa19c6845758ab08074a0cfa8b7aecb71c999ca73d62883bc25cc018c4e548
diff --git a/src/backend/requirements.in b/src/backend/requirements.in
index 5268cc9241..18e64dcbca 100644
--- a/src/backend/requirements.in
+++ b/src/backend/requirements.in
@@ -52,6 +52,7 @@ rapidfuzz                               # Fuzzy string matching
 sentry-sdk                              # Error reporting (optional)
 setuptools                              # Standard dependency
 tablib[xls,xlsx,yaml]                   # Support for XLS and XLSX formats
+tqdm                                    # Progress bars for CLI
 weasyprint                              # PDF generation
 whitenoise                              # Enhanced static file serving
 
diff --git a/src/backend/requirements.txt b/src/backend/requirements.txt
index 2d730180a4..0bcd65f018 100644
--- a/src/backend/requirements.txt
+++ b/src/backend/requirements.txt
@@ -1916,6 +1916,10 @@ tinyhtml5==2.1.0 \
     --hash=sha256:60a50ec3d938a37e491efa01af895853060943dcebb5627de5b10d188b338a67 \
     --hash=sha256:6e11cfff38515834268daf89d5f85bbde0b6dd02e8d9e212d1385c2289b89f0a
     # via weasyprint
+tqdm==4.67.3 \
+    --hash=sha256:7d825f03f89244ef73f1d4ce193cb1774a8179fd96f31d7e1dcde62092b960bb \
+    --hash=sha256:ee1e4c0e59148062281c49d80b25b67771a127c85fc9676d3be5f243206826bf
+    # via -r src/backend/requirements.in
 typing-extensions==4.15.0 \
     --hash=sha256:0cea48d173cc12fa28ecabc3b837ea3cf6f38c6d1136f85cbaaf598984861466 \
     --hash=sha256:f0fa19c6845758ab08074a0cfa8b7aecb71c999ca73d62883bc25cc018c4e548
diff --git a/src/frontend/src/components/items/AttachmentLink.tsx b/src/frontend/src/components/items/AttachmentLink.tsx
index 8922e0cb37..4836cd122b 100644
--- a/src/frontend/src/components/items/AttachmentLink.tsx
+++ b/src/frontend/src/components/items/AttachmentLink.tsx
@@ -12,6 +12,7 @@ import {
 } from '@tabler/icons-react';
 import { type ReactNode, useMemo } from 'react';
 import { generateUrl } from '../../functions/urls';
+import { Thumbnail } from '../images/Thumbnail';
 
 /**
  * Return an icon based on the provided filename
@@ -59,9 +60,11 @@ export function attachmentIcon(attachment: string): ReactNode {
  */
 export function AttachmentLink({
   attachment,
+  thumbnail,
   external
 }: Readonly<{
   attachment: string;
+  thumbnail?: string;
   external?: boolean;
 }>): ReactNode {
   const url = useMemo(() => {
@@ -82,7 +85,13 @@ export function AttachmentLink({
 
   return (
     <Group justify='left' gap='sm' wrap='nowrap'>
-      {external ? <IconLink /> : attachmentIcon(attachment)}
+      {thumbnail ? (
+        <Thumbnail src={thumbnail} hover size={16} />
+      ) : external ? (
+        <IconLink />
+      ) : (
+        attachmentIcon(attachment)
+      )}
       {!!attachment ? (
         <Anchor href={url} target='_blank' rel='noopener noreferrer'>
           {text}
diff --git a/src/frontend/src/pages/Index/Settings/SystemSettings.tsx b/src/frontend/src/pages/Index/Settings/SystemSettings.tsx
index 409110efee..03d369be91 100644
--- a/src/frontend/src/pages/Index/Settings/SystemSettings.tsx
+++ b/src/frontend/src/pages/Index/Settings/SystemSettings.tsx
@@ -57,6 +57,7 @@ export default function SystemSettings() {
                 'DISPLAY_FULL_NAMES',
                 'DISPLAY_PROFILE_INFO',
                 'WEEK_STARTS_ON',
+                'INVENTREE_UPLOAD_MAX_SIZE',
                 'INVENTREE_STRICT_URLS'
               ]}
             />
diff --git a/src/frontend/src/tables/general/AttachmentTable.tsx b/src/frontend/src/tables/general/AttachmentTable.tsx
index c31993ae80..6db7a83766 100644
--- a/src/frontend/src/tables/general/AttachmentTable.tsx
+++ b/src/frontend/src/tables/general/AttachmentTable.tsx
@@ -49,7 +49,12 @@ function attachmentTableColumns(): TableColumn[] {
       noWrap: true,
       render: (record: any) => {
         if (record.attachment) {
-          return <AttachmentLink attachment={record.attachment} />;
+          return (
+            <AttachmentLink
+              thumbnail={record.thumbnail}
+              attachment={record.attachment}
+            />
+          );
         } else if (record.link) {
           return <AttachmentLink attachment={record.link} external />;
         } else {
@@ -300,6 +305,11 @@ export function AttachmentTable({
         name: 'is_file',
         label: t`Is File`,
         description: t`Show file attachments`
+      },
+      {
+        name: 'is_image',
+        label: t`Is Image`,
+        description: t`Show image attachments`
       }
     ];
   }, []);