From 8ff20413ceba2bf0e7c76fb511c4387894930ced Mon Sep 17 00:00:00 2001
From: Ishpaul Singh <ishpaul207@gmail.com>
Date: Sat, 11 Apr 2026 05:26:46 +0530
Subject: [PATCH 01/16] Add workspace rules PDF document upload, view, and
 management

Allow workspace admins to upload, replace, and remove a PDF document
on the workspace overview page. Non-admins can view and download it.
PDFs are stored in a private S3 bucket and served through an
authenticated streaming endpoint.
---
 src/ROUTES.ts                                 |   4 +
 src/SCREENS.ts                                |   1 +
 .../DeleteWorkspaceRulesDocumentParams.ts     |   5 +
 .../UpdateWorkspaceRulesDocumentParams.ts     |   6 +
 src/libs/API/parameters/index.ts              |   2 +
 src/libs/API/types.ts                         |   4 +
 .../Navigation/AppNavigator/AuthScreens.tsx   |   6 +
 .../GetStateForActionHandlers.ts              |   1 +
 src/libs/Navigation/linkingConfig/config.ts   |   1 +
 src/libs/Navigation/types.ts                  |   3 +
 src/libs/PolicyUtils.ts                       |  27 +++++
 src/libs/actions/Policy/Policy.ts             |  93 +++++++++++++++
 .../media/AttachmentModalScreen/index.tsx     |  10 ++
 .../routes/WorkspaceDocumentModalContent.tsx  |  49 ++++++++
 .../media/AttachmentModalScreen/types.ts      |   1 +
 src/pages/workspace/WorkspaceOverviewPage.tsx | 108 +++++++++++++++++-
 src/types/onyx/Policy.ts                      |   3 +
 17 files changed, 320 insertions(+), 4 deletions(-)
 create mode 100644 src/libs/API/parameters/DeleteWorkspaceRulesDocumentParams.ts
 create mode 100644 src/libs/API/parameters/UpdateWorkspaceRulesDocumentParams.ts
 create mode 100644 src/pages/media/AttachmentModalScreen/routes/WorkspaceDocumentModalContent.tsx

diff --git a/src/ROUTES.ts b/src/ROUTES.ts
index 2c30d1f3d2cd..e86dd001ca4d 100644
--- a/src/ROUTES.ts
+++ b/src/ROUTES.ts
@@ -2118,6 +2118,10 @@ const ROUTES = {
         route: 'workspaces/:policyID/avatar',
         getRoute: (policyID: string, fallbackLetter?: UpperCaseCharacters) => `workspaces/${policyID}/avatar${fallbackLetter ? `?letter=${fallbackLetter}` : ''}` as const,
     },
+    WORKSPACE_DOCUMENT: {
+        route: 'workspaces/:policyID/document',
+        getRoute: (policyID: string) => `workspaces/${policyID}/document` as const,
+    },
     WORKSPACE_JOIN_USER: {
         route: 'workspaces/:policyID/join',
         getRoute: (policyID: string, inviterEmail: string) => `workspaces/${policyID}/join?email=${inviterEmail}` as const,
diff --git a/src/SCREENS.ts b/src/SCREENS.ts
index 387edc01db54..118316b6f4f6 100644
--- a/src/SCREENS.ts
+++ b/src/SCREENS.ts
@@ -19,6 +19,7 @@ const SCREENS = {
     REPORT: 'Report',
     PROFILE_AVATAR: 'ProfileAvatar',
     WORKSPACE_AVATAR: 'WorkspaceAvatar',
+    WORKSPACE_DOCUMENT: 'WorkspaceDocument',
     REPORT_AVATAR: 'ReportAvatar',
     NOT_FOUND: 'not-found',
     TRANSITION_BETWEEN_APPS: 'TransitionBetweenApps',
diff --git a/src/libs/API/parameters/DeleteWorkspaceRulesDocumentParams.ts b/src/libs/API/parameters/DeleteWorkspaceRulesDocumentParams.ts
new file mode 100644
index 000000000000..1cff382e8b76
--- /dev/null
+++ b/src/libs/API/parameters/DeleteWorkspaceRulesDocumentParams.ts
@@ -0,0 +1,5 @@
+type DeleteWorkspaceRulesDocumentParams = {
+    policyID: string;
+};
+
+export default DeleteWorkspaceRulesDocumentParams;
diff --git a/src/libs/API/parameters/UpdateWorkspaceRulesDocumentParams.ts b/src/libs/API/parameters/UpdateWorkspaceRulesDocumentParams.ts
new file mode 100644
index 000000000000..8539b6dfda84
--- /dev/null
+++ b/src/libs/API/parameters/UpdateWorkspaceRulesDocumentParams.ts
@@ -0,0 +1,6 @@
+type UpdateWorkspaceRulesDocumentParams = {
+    policyID: string;
+    file: File;
+};
+
+export default UpdateWorkspaceRulesDocumentParams;
diff --git a/src/libs/API/parameters/index.ts b/src/libs/API/parameters/index.ts
index dfbde3571fcd..f9477e819f10 100644
--- a/src/libs/API/parameters/index.ts
+++ b/src/libs/API/parameters/index.ts
@@ -164,6 +164,8 @@ export type {default as CreateWorkspaceParams} from './CreateWorkspaceParams';
 export type {default as UpdateWorkspaceGeneralSettingsParams} from './UpdateWorkspaceGeneralSettingsParams';
 export type {default as DeleteWorkspaceAvatarParams} from './DeleteWorkspaceAvatarParams';
 export type {default as UpdateWorkspaceAvatarParams} from './UpdateWorkspaceAvatarParams';
+export type {default as UpdateWorkspaceRulesDocumentParams} from './UpdateWorkspaceRulesDocumentParams';
+export type {default as DeleteWorkspaceRulesDocumentParams} from './DeleteWorkspaceRulesDocumentParams';
 export type {default as AddMembersToWorkspaceParams} from './AddMembersToWorkspaceParams';
 export type {default as DeleteMembersFromWorkspaceParams} from './DeleteMembersFromWorkspaceParams';
 export type {default as OpenWorkspaceParams} from './OpenWorkspaceParams';
diff --git a/src/libs/API/types.ts b/src/libs/API/types.ts
index 0c6a1e5b6e52..592c39eedcea 100644
--- a/src/libs/API/types.ts
+++ b/src/libs/API/types.ts
@@ -154,6 +154,8 @@ const WRITE_COMMANDS = {
     ADD_MEMBERS_TO_WORKSPACE: 'AddMembersToWorkspace',
     UPDATE_WORKSPACE_AVATAR: 'UpdateWorkspaceAvatar',
     DELETE_WORKSPACE_AVATAR: 'DeleteWorkspaceAvatar',
+    UPDATE_WORKSPACE_RULES_DOCUMENT: 'UpdateWorkspaceRulesDocument',
+    DELETE_WORKSPACE_RULES_DOCUMENT: 'DeleteWorkspaceRulesDocument',
     UPDATE_WORKSPACE_GENERAL_SETTINGS: 'UpdateWorkspaceGeneralSettings',
     UPDATE_WORKSPACE_DESCRIPTION: 'UpdateWorkspaceDescription',
     UPDATE_WORKSPACE_CLIENT_ID: 'UpdateWorkspaceClientID',
@@ -726,6 +728,8 @@ type WriteCommandParameters = {
     [WRITE_COMMANDS.ADD_MEMBERS_TO_WORKSPACE]: Parameters.AddMembersToWorkspaceParams;
     [WRITE_COMMANDS.UPDATE_WORKSPACE_AVATAR]: Parameters.UpdateWorkspaceAvatarParams;
     [WRITE_COMMANDS.DELETE_WORKSPACE_AVATAR]: Parameters.DeleteWorkspaceAvatarParams;
+    [WRITE_COMMANDS.UPDATE_WORKSPACE_RULES_DOCUMENT]: Parameters.UpdateWorkspaceRulesDocumentParams;
+    [WRITE_COMMANDS.DELETE_WORKSPACE_RULES_DOCUMENT]: Parameters.DeleteWorkspaceRulesDocumentParams;
     [WRITE_COMMANDS.UPDATE_WORKSPACE_GENERAL_SETTINGS]: Parameters.UpdateWorkspaceGeneralSettingsParams;
     [WRITE_COMMANDS.UPDATE_WORKSPACE_DESCRIPTION]: Parameters.UpdateWorkspaceDescriptionParams;
     [WRITE_COMMANDS.UPDATE_WORKSPACE_CLIENT_ID]: Parameters.UpdateWorkspaceClientIDParams;
diff --git a/src/libs/Navigation/AppNavigator/AuthScreens.tsx b/src/libs/Navigation/AppNavigator/AuthScreens.tsx
index 9b381ec63314..078809a912c5 100644
--- a/src/libs/Navigation/AppNavigator/AuthScreens.tsx
+++ b/src/libs/Navigation/AppNavigator/AuthScreens.tsx
@@ -283,6 +283,12 @@ function AuthScreens() {
                             getComponent={loadAttachmentModalScreen}
                             listeners={modalScreenListeners}
                         />
+                        <RootStack.Screen
+                            name={SCREENS.WORKSPACE_DOCUMENT}
+                            options={attachmentModalScreenOptions}
+                            getComponent={loadAttachmentModalScreen}
+                            listeners={modalScreenListeners}
+                        />
                         <RootStack.Screen
                             name={SCREENS.TRANSACTION_RECEIPT}
                             options={attachmentModalScreenOptions}
diff --git a/src/libs/Navigation/AppNavigator/createRootStackNavigator/GetStateForActionHandlers.ts b/src/libs/Navigation/AppNavigator/createRootStackNavigator/GetStateForActionHandlers.ts
index d8b150fbcf54..72ae9b81b4fc 100644
--- a/src/libs/Navigation/AppNavigator/createRootStackNavigator/GetStateForActionHandlers.ts
+++ b/src/libs/Navigation/AppNavigator/createRootStackNavigator/GetStateForActionHandlers.ts
@@ -36,6 +36,7 @@ const MODAL_ROUTES_TO_DISMISS = new Set<string>([
     SCREENS.MONEY_REQUEST.ODOMETER_PREVIEW,
     SCREENS.PROFILE_AVATAR,
     SCREENS.WORKSPACE_AVATAR,
+    SCREENS.WORKSPACE_DOCUMENT,
     SCREENS.REPORT_AVATAR,
     SCREENS.CONCIERGE,
     SCREENS.SEARCH_ROUTER.ROOT,
diff --git a/src/libs/Navigation/linkingConfig/config.ts b/src/libs/Navigation/linkingConfig/config.ts
index 9aba217a1624..90d387442d16 100644
--- a/src/libs/Navigation/linkingConfig/config.ts
+++ b/src/libs/Navigation/linkingConfig/config.ts
@@ -33,6 +33,7 @@ const config: LinkingOptions<RootNavigatorParamList>['config'] = {
             },
         },
         [SCREENS.WORKSPACE_AVATAR]: ROUTES.WORKSPACE_AVATAR.route,
+        [SCREENS.WORKSPACE_DOCUMENT]: ROUTES.WORKSPACE_DOCUMENT.route,
         [SCREENS.REPORT_AVATAR]: ROUTES.REPORT_AVATAR.route,
         [SCREENS.TRANSACTION_RECEIPT]: ROUTES.TRANSACTION_RECEIPT.route,
         [SCREENS.MONEY_REQUEST.RECEIPT_PREVIEW]: ROUTES.MONEY_REQUEST_RECEIPT_PREVIEW.route,
diff --git a/src/libs/Navigation/types.ts b/src/libs/Navigation/types.ts
index 4e8cccf47262..b7f386c49ec1 100644
--- a/src/libs/Navigation/types.ts
+++ b/src/libs/Navigation/types.ts
@@ -2987,6 +2987,9 @@ type AttachmentModalScreensParamList = {
         policyID: string;
         letter?: UpperCaseCharacters;
     };
+    [SCREENS.WORKSPACE_DOCUMENT]: AttachmentModalContainerModalProps & {
+        policyID: string;
+    };
     [SCREENS.REPORT_AVATAR]: AttachmentModalContainerModalProps & {
         reportID: string;
         policyID?: string;
diff --git a/src/libs/PolicyUtils.ts b/src/libs/PolicyUtils.ts
index 3c725937bd42..6ad6b60bb0f7 100644
--- a/src/libs/PolicyUtils.ts
+++ b/src/libs/PolicyUtils.ts
@@ -47,6 +47,8 @@ import {isEmptyObject} from '@src/types/utils/EmptyObject';
 import {getBankAccountFromID} from './actions/BankAccounts';
 import {hasSynchronizationErrorMessage, isConnectionUnverified} from './actions/connections';
 import {shouldShowQBOReimbursableExportDestinationAccountError} from './actions/connections/QuickbooksOnline';
+import addEncryptedAuthTokenToURL from './addEncryptedAuthTokenToURL';
+import {getApiRoot} from './ApiUtils';
 import {getCategoryApproverRule} from './CategoryUtils';
 import {convertToBackendAmount} from './CurrencyUtils';
 import Navigation from './Navigation/Navigation';
@@ -2152,6 +2154,30 @@ function sortPoliciesByName(policies: Policy[], localeCompare: (a: string, b: st
     return policies.sort((a, b) => localeCompare(a.name || '', b.name || ''));
 }
 
+/**
+ * Builds a source URL for rendering a policy document PDF.
+ * Local blob/file URIs (from optimistic uploads) are returned directly.
+ * Remote URLs are routed through the authenticated GetPolicyDocument streaming endpoint.
+ * The stored URL (which contains a unique timestamp per upload) is appended as a version
+ * parameter so the browser treats each replacement as a distinct resource.
+ */
+function getPolicyDocumentSourceURL(policyDocumentURL: string | undefined, policyID: string | undefined, encryptedAuthToken: string): string {
+    if (!policyDocumentURL || !policyID) {
+        return '';
+    }
+
+    const isLocalFile = policyDocumentURL.startsWith('blob:') || policyDocumentURL.startsWith('file:');
+    if (isLocalFile) {
+        return policyDocumentURL;
+    }
+
+    return addEncryptedAuthTokenToURL(
+        `${getApiRoot({shouldUseSecure: false})}api/GetPolicyDocument?policyID=${policyID}&v=${encodeURIComponent(policyDocumentURL)}`,
+        encryptedAuthToken,
+        true,
+    );
+}
+
 export {
     canEditTaxRate,
     canPolicyAccessFeature,
@@ -2335,6 +2361,7 @@ export {
     isPolicyTaxEnabled,
     sortPoliciesByName,
     isPolicyApprover,
+    getPolicyDocumentSourceURL,
 };
 
 export type {MemberEmailsToAccountIDs};
diff --git a/src/libs/actions/Policy/Policy.ts b/src/libs/actions/Policy/Policy.ts
index 95c4bc61c55e..9cbe265a643e 100644
--- a/src/libs/actions/Policy/Policy.ts
+++ b/src/libs/actions/Policy/Policy.ts
@@ -16,6 +16,7 @@ import type {
     CreateWorkspaceParams,
     DeleteWorkspaceAvatarParams,
     DeleteWorkspaceParams,
+    DeleteWorkspaceRulesDocumentParams,
     DisablePolicyApprovalsParams,
     DisablePolicyBillableModeParams,
     DowngradeToTeamParams,
@@ -71,6 +72,7 @@ import type {
     UpdateWorkspaceClientIDParams,
     UpdateWorkspaceDescriptionParams,
     UpdateWorkspaceGeneralSettingsParams,
+    UpdateWorkspaceRulesDocumentParams,
     UpgradeToCorporateParams,
 } from '@libs/API/parameters';
 import type SetPolicyCashExpenseModeParams from '@libs/API/parameters/SetPolicyCashExpenseModeParams';
@@ -1805,6 +1807,95 @@ function deleteWorkspaceAvatar(policyID: string, currentAvatarURL: string, curre
     API.write(WRITE_COMMANDS.DELETE_WORKSPACE_AVATAR, params, {optimisticData, finallyData, failureData});
 }
 
+function updateWorkspaceRulesDocument(policyID: string, file: File, currentDocumentURL: string | undefined) {
+    const optimisticData: Array<OnyxUpdate<typeof ONYXKEYS.COLLECTION.POLICY>> = [
+        {
+            onyxMethod: Onyx.METHOD.MERGE,
+            key: `${ONYXKEYS.COLLECTION.POLICY}${policyID}`,
+            value: {
+                policyDocumentURL: file.uri,
+                errorFields: {
+                    policyDocumentURL: null,
+                },
+                pendingFields: {
+                    policyDocumentURL: CONST.RED_BRICK_ROAD_PENDING_ACTION.UPDATE,
+                },
+            },
+        },
+    ];
+    const finallyData: Array<OnyxUpdate<typeof ONYXKEYS.COLLECTION.POLICY>> = [
+        {
+            onyxMethod: Onyx.METHOD.MERGE,
+            key: `${ONYXKEYS.COLLECTION.POLICY}${policyID}`,
+            value: {
+                pendingFields: {
+                    policyDocumentURL: null,
+                },
+            },
+        },
+    ];
+    const failureData: Array<OnyxUpdate<typeof ONYXKEYS.COLLECTION.POLICY>> = [
+        {
+            onyxMethod: Onyx.METHOD.MERGE,
+            key: `${ONYXKEYS.COLLECTION.POLICY}${policyID}`,
+            value: {
+                policyDocumentURL: currentDocumentURL ?? '',
+                errorFields: {policyDocumentURL: ErrorUtils.getMicroSecondOnyxErrorWithTranslationKey('common.genericErrorMessage')},
+            },
+        },
+    ];
+
+    const params: UpdateWorkspaceRulesDocumentParams = {
+        policyID,
+        file,
+    };
+
+    API.write(WRITE_COMMANDS.UPDATE_WORKSPACE_RULES_DOCUMENT, params, {optimisticData, finallyData, failureData});
+}
+
+function deleteWorkspaceRulesDocument(policyID: string, currentDocumentURL: string) {
+    const optimisticData: Array<OnyxUpdate<typeof ONYXKEYS.COLLECTION.POLICY>> = [
+        {
+            onyxMethod: Onyx.METHOD.MERGE,
+            key: `${ONYXKEYS.COLLECTION.POLICY}${policyID}`,
+            value: {
+                policyDocumentURL: '',
+                errorFields: {
+                    policyDocumentURL: null,
+                },
+                pendingFields: {
+                    policyDocumentURL: CONST.RED_BRICK_ROAD_PENDING_ACTION.UPDATE,
+                },
+            },
+        },
+    ];
+    const finallyData: Array<OnyxUpdate<typeof ONYXKEYS.COLLECTION.POLICY>> = [
+        {
+            onyxMethod: Onyx.METHOD.MERGE,
+            key: `${ONYXKEYS.COLLECTION.POLICY}${policyID}`,
+            value: {
+                pendingFields: {
+                    policyDocumentURL: null,
+                },
+            },
+        },
+    ];
+    const failureData: Array<OnyxUpdate<typeof ONYXKEYS.COLLECTION.POLICY>> = [
+        {
+            onyxMethod: Onyx.METHOD.MERGE,
+            key: `${ONYXKEYS.COLLECTION.POLICY}${policyID}`,
+            value: {
+                policyDocumentURL: currentDocumentURL,
+                errorFields: {policyDocumentURL: ErrorUtils.getMicroSecondOnyxErrorWithTranslationKey('common.genericErrorMessage')},
+            },
+        },
+    ];
+
+    const params: DeleteWorkspaceRulesDocumentParams = {policyID};
+
+    API.write(WRITE_COMMANDS.DELETE_WORKSPACE_RULES_DOCUMENT, params, {optimisticData, finallyData, failureData});
+}
+
 /**
  * Clear error and pending fields for the workspace avatar
  */
@@ -7115,6 +7206,8 @@ export {
     updateGeneralSettings,
     deleteWorkspaceAvatar,
     updateWorkspaceAvatar,
+    updateWorkspaceRulesDocument,
+    deleteWorkspaceRulesDocument,
     clearAvatarErrors,
     generatePolicyID,
     createWorkspace,
diff --git a/src/pages/media/AttachmentModalScreen/index.tsx b/src/pages/media/AttachmentModalScreen/index.tsx
index 52ce70838483..531ee1eeb0af 100644
--- a/src/pages/media/AttachmentModalScreen/index.tsx
+++ b/src/pages/media/AttachmentModalScreen/index.tsx
@@ -9,6 +9,7 @@ import ReportAvatarModalContent from './routes/report/ReportAvatarModalContent';
 import ShareDetailsAttachmentModalContent from './routes/ShareDetailsAttachmentModalContent';
 import TransactionReceiptModalContent from './routes/TransactionReceiptModalContent';
 import WorkspaceAvatarModalContent from './routes/WorkspaceAvatarModalContent';
+import WorkspaceDocumentModalContent from './routes/WorkspaceDocumentModalContent';
 import type {AttachmentModalScreenProps, AttachmentModalScreenType} from './types';
 
 type RouteType<Screen extends AttachmentModalScreenType> = AttachmentModalScreenProps<Screen>['route'];
@@ -74,6 +75,15 @@ function AttachmentModalScreen<Screen extends AttachmentModalScreenType>({route,
         );
     }
 
+    if (route.name === SCREENS.WORKSPACE_DOCUMENT) {
+        return (
+            <WorkspaceDocumentModalContent
+                route={routeWithContext as RouteType<typeof SCREENS.WORKSPACE_DOCUMENT>}
+                navigation={navigation as NavigationType<typeof SCREENS.WORKSPACE_DOCUMENT>}
+            />
+        );
+    }
+
     if (route.name === SCREENS.REPORT_AVATAR) {
         return (
             <ReportAvatarModalContent
diff --git a/src/pages/media/AttachmentModalScreen/routes/WorkspaceDocumentModalContent.tsx b/src/pages/media/AttachmentModalScreen/routes/WorkspaceDocumentModalContent.tsx
new file mode 100644
index 000000000000..892a060c7370
--- /dev/null
+++ b/src/pages/media/AttachmentModalScreen/routes/WorkspaceDocumentModalContent.tsx
@@ -0,0 +1,49 @@
+import React, {useMemo} from 'react';
+import useOnyx from '@hooks/useOnyx';
+import usePolicy from '@hooks/usePolicy';
+import {getPolicyDocumentSourceURL} from '@libs/PolicyUtils';
+import type {AttachmentModalBaseContentProps} from '@pages/media/AttachmentModalScreen/AttachmentModalBaseContent/types';
+import AttachmentModalContainer from '@pages/media/AttachmentModalScreen/AttachmentModalContainer';
+import type {AttachmentModalScreenProps} from '@pages/media/AttachmentModalScreen/types';
+import ONYXKEYS from '@src/ONYXKEYS';
+import type SCREENS from '@src/SCREENS';
+
+function WorkspaceDocumentModalContent({navigation, route}: AttachmentModalScreenProps<typeof SCREENS.WORKSPACE_DOCUMENT>) {
+    const {policyID} = route.params;
+
+    const [session] = useOnyx(ONYXKEYS.SESSION);
+    const policy = usePolicy(policyID);
+    const [isLoadingApp = false] = useOnyx(ONYXKEYS.IS_LOADING_APP, {initWithStoredValues: false});
+
+    const policyKeysLength = Object.keys(policy ?? {}).length;
+
+    // eslint-disable-next-line rulesdir/no-negated-variables
+    const shouldShowNotFoundPage = (policyKeysLength === 0 && !isLoadingApp) || !policy?.policyDocumentURL;
+    const isLoading = policyKeysLength === 0 && !!isLoadingApp;
+
+    const policyDocumentSourceURL = useMemo(
+        () => getPolicyDocumentSourceURL(policy?.policyDocumentURL, policyID, session?.encryptedAuthToken ?? ''),
+        [policy?.policyDocumentURL, policyID, session?.encryptedAuthToken],
+    );
+
+    const contentProps = useMemo<AttachmentModalBaseContentProps>(
+        () => ({
+            source: policyDocumentSourceURL,
+            headerTitle: policy?.name ?? '',
+            originalFileName: `${policyID}-policy-document.pdf`,
+            shouldShowNotFoundPage,
+            isLoading,
+            shouldCloseOnSwipeDown: true,
+        }),
+        [policyDocumentSourceURL, policy?.name, policyID, shouldShowNotFoundPage, isLoading],
+    );
+
+    return (
+        <AttachmentModalContainer
+            navigation={navigation}
+            contentProps={contentProps}
+        />
+    );
+}
+
+export default WorkspaceDocumentModalContent;
diff --git a/src/pages/media/AttachmentModalScreen/types.ts b/src/pages/media/AttachmentModalScreen/types.ts
index 09360f0fa2c0..0fd6cfd60ada 100644
--- a/src/pages/media/AttachmentModalScreen/types.ts
+++ b/src/pages/media/AttachmentModalScreen/types.ts
@@ -27,6 +27,7 @@ type AttachmentModalScreenType =
     | typeof SCREENS.REPORT_AVATAR
     | typeof SCREENS.PROFILE_AVATAR
     | typeof SCREENS.WORKSPACE_AVATAR
+    | typeof SCREENS.WORKSPACE_DOCUMENT
     | typeof SCREENS.TRANSACTION_RECEIPT
     | typeof SCREENS.MONEY_REQUEST.RECEIPT_PREVIEW
     | typeof SCREENS.MONEY_REQUEST.ODOMETER_PREVIEW
diff --git a/src/pages/workspace/WorkspaceOverviewPage.tsx b/src/pages/workspace/WorkspaceOverviewPage.tsx
index f104e84f9421..c5367aa9bfb6 100644
--- a/src/pages/workspace/WorkspaceOverviewPage.tsx
+++ b/src/pages/workspace/WorkspaceOverviewPage.tsx
@@ -1,7 +1,8 @@
 import {useFocusEffect, useIsFocused} from '@react-navigation/native';
-import React, {useCallback, useEffect, useRef, useState} from 'react';
+import React, {useCallback, useEffect, useMemo, useRef, useState} from 'react';
 import {View} from 'react-native';
 import type {ValueOf} from 'type-fest';
+import AttachmentPicker from '@components/AttachmentPicker';
 import Avatar from '@components/Avatar';
 import AvatarWithImagePicker from '@components/AvatarWithImagePicker';
 import Button from '@components/Button';
@@ -13,7 +14,12 @@ import {useLockedAccountActions, useLockedAccountState} from '@components/Locked
 import MenuItemWithTopDescription from '@components/MenuItemWithTopDescription';
 import OfflineWithFeedback from '@components/OfflineWithFeedback';
 import {usePersonalDetails} from '@components/OnyxListItemProvider';
+import PDFThumbnail from '@components/PDFThumbnail';
+import type {PopoverMenuItem} from '@components/PopoverMenu';
+import PressableWithoutFeedback from '@components/Pressable/PressableWithoutFeedback';
 import Section from '@components/Section';
+import Text from '@components/Text';
+import ThreeDotsMenu from '@components/ThreeDotsMenu';
 import useCardFeeds from '@hooks/useCardFeeds';
 import {useCurrencyListActions} from '@hooks/useCurrencyList';
 import useCurrentUserPersonalDetails from '@hooks/useCurrentUserPersonalDetails';
@@ -41,10 +47,12 @@ import {
     clearPolicyErrorField,
     deleteWorkspace,
     deleteWorkspaceAvatar,
+    deleteWorkspaceRulesDocument,
     leaveWorkspace,
     openPolicyProfilePage,
     setIsComingFromGlobalReimbursementsFlow,
     updateWorkspaceAvatar,
+    updateWorkspaceRulesDocument,
 } from '@libs/actions/Policy/Policy';
 import {filterInactiveCards, getCardSettings} from '@libs/CardUtils';
 import {getLatestErrorField, getLatestErrorMessage} from '@libs/ErrorUtils';
@@ -54,6 +62,7 @@ import type {PlatformStackScreenProps} from '@libs/Navigation/PlatformStackNavig
 import type {WorkspaceSplitNavigatorParamList} from '@libs/Navigation/types';
 import {
     getConnectionExporters,
+    getPolicyDocumentSourceURL,
     getUserFriendlyWorkspaceType,
     goBackFromInvalidPolicy,
     isPendingDeletePolicy,
@@ -75,6 +84,7 @@ import type SCREENS from '@src/SCREENS';
 import {accountIDToLoginSelector} from '@src/selectors/PersonalDetails';
 import {ownerPoliciesSelector} from '@src/selectors/Policy';
 import {reimbursementAccountErrorSelector} from '@src/selectors/ReimbursementAccount';
+import type {FileObject} from '@src/types/utils/Attachment';
 import {isEmptyObject} from '@src/types/utils/EmptyObject';
 import type {WithPolicyProps} from './withPolicy';
 import withPolicy from './withPolicy';
@@ -89,7 +99,7 @@ function WorkspaceOverviewPage({policyDraft, policy: policyProp, route}: Workspa
     const currentUserPersonalDetails = useCurrentUserPersonalDetails();
     const {getCurrencySymbol} = useCurrencyListActions();
     const illustrationIcons = useMemoizedLazyIllustrations(['Building']);
-    const expensifyIcons = useMemoizedLazyExpensifyIcons(['Exit', 'FallbackWorkspaceAvatar', 'ImageCropSquareMask', 'QrCode', 'Transfer', 'Trashcan', 'UserPlus']);
+    const expensifyIcons = useMemoizedLazyExpensifyIcons(['Exit', 'FallbackWorkspaceAvatar', 'ImageCropSquareMask', 'QrCode', 'Transfer', 'Trashcan', 'Upload', 'UserPlus']);
 
     const backTo = route.params.backTo;
     const [account] = useOnyx(ONYXKEYS.ACCOUNT);
@@ -185,6 +195,12 @@ function WorkspaceOverviewPage({policyDraft, policy: policyProp, route}: Workspa
     const {isBetaEnabled} = usePermissions();
     const [isLeaveModalOpen, setIsLeaveModalOpen] = useState(false);
     const [session] = useOnyx(ONYXKEYS.SESSION);
+
+    const policyDocumentSourceURL = useMemo(
+        () => getPolicyDocumentSourceURL(policy?.policyDocumentURL, policyID, session?.encryptedAuthToken ?? ''),
+        [policy?.policyDocumentURL, policyID, session?.encryptedAuthToken],
+    );
+
     const personalDetails = usePersonalDetails();
     const [accountIDToLogin] = useOnyx(ONYXKEYS.PERSONAL_DETAILS_LIST, {selector: accountIDToLoginSelector(reportsToArchive)});
     const [isCannotLeaveWorkspaceModalOpen, setIsCannotLeaveWorkspaceModalOpen] = useState(false);
@@ -423,6 +439,33 @@ function WorkspaceOverviewPage({policyDraft, policy: policyProp, route}: Workspa
         return translate('common.leaveWorkspaceConfirmation');
     };
 
+    const getPolicyDocumentMenuItems = (openPicker: (options: {onPicked: (files: FileObject[]) => void}) => void): PopoverMenuItem[] => [
+        {
+            text: translate('common.replace'),
+            icon: expensifyIcons.Upload,
+            onSelected: () => {
+                openPicker({
+                    onPicked: (files: FileObject[]) => {
+                        if (!policyID || !files.length) {
+                            return;
+                        }
+                        updateWorkspaceRulesDocument(policyID, files.at(0) as File, policy?.policyDocumentURL);
+                    },
+                });
+            },
+        },
+        {
+            text: translate('common.remove'),
+            icon: expensifyIcons.Trashcan,
+            onSelected: () => {
+                if (!policyID || !policy?.policyDocumentURL) {
+                    return;
+                }
+                deleteWorkspaceRulesDocument(policyID, policy.policyDocumentURL);
+            },
+        },
+    ];
+
     const handleInvitePress = () => {
         if (isAccountLocked) {
             showLockedAccountModal();
@@ -757,13 +800,70 @@ function WorkspaceOverviewPage({policyDraft, policy: policyProp, route}: Workspa
                 {isBetaEnabled(CONST.BETAS.CUSTOM_RULES) ? (
                     <Section
                         isCentralPane
-                        title={translate('workspace.editor.policy')}
+                        title={translate('workspace.rules.customRules.title')}
                         titleStyles={[styles.textHeadline, styles.cardSectionTitle, styles.accountSettingsSectionTitle, styles.mb0]}
                         subtitle={translate('workspace.rules.customRules.cardSubtitle')}
                         subtitleStyles={[styles.mb6]}
                         subtitleTextStyles={[styles.textNormal, styles.colorMuted, styles.mr5]}
                         containerStyles={shouldUseNarrowLayout ? styles.p5 : styles.p8}
                     >
+                        <OfflineWithFeedback pendingAction={policy?.pendingFields?.policyDocumentURL}>
+                            <Text style={[styles.mutedTextLabel, styles.mb2]}>{translate('workspace.rules.customRules.policyDocument')}</Text>
+                            <AttachmentPicker acceptedFileTypes={['pdf']}>
+                                {({openPicker}) => {
+                                    if (policy?.policyDocumentURL) {
+                                        return (
+                                            <View style={[styles.flexRow, styles.alignItemsStart]}>
+                                                <PressableWithoutFeedback
+                                                    onPress={() => {
+                                                        if (!policyID) {
+                                                            return;
+                                                        }
+                                                        Navigation.navigate(ROUTES.WORKSPACE_DOCUMENT.getRoute(policyID));
+                                                    }}
+                                                    role={CONST.ROLE.BUTTON}
+                                                    accessibilityLabel={translate('workspace.rules.customRules.policyDocument')}
+                                                    style={[styles.border, styles.borderRadiusComponentLarge, styles.overflowHidden, {width: 200, height: 260}]}
+                                                >
+                                                    <PDFThumbnail
+                                                        previewSourceURL={policyDocumentSourceURL}
+                                                        style={{width: 200, height: 260}}
+                                                    />
+                                                </PressableWithoutFeedback>
+                                                {isPolicyAdmin && (
+                                                    <ThreeDotsMenu
+                                                        menuItems={getPolicyDocumentMenuItems(openPicker)}
+                                                        shouldSelfPosition
+                                                    />
+                                                )}
+                                            </View>
+                                        );
+                                    }
+
+                                    if (!isPolicyAdmin) {
+                                        return null;
+                                    }
+
+                                    return (
+                                        <Button
+                                            medium
+                                            text={translate('common.chooseFile')}
+                                            onPress={() => {
+                                                openPicker({
+                                                    onPicked: (files) => {
+                                                        if (!policyID || !files.length) {
+                                                            return;
+                                                        }
+                                                        updateWorkspaceRulesDocument(policyID, files.at(0) as File, policy?.policyDocumentURL);
+                                                    },
+                                                });
+                                            }}
+                                        />
+                                    );
+                                }}
+                            </AttachmentPicker>
+                        </OfflineWithFeedback>
+
                         <OfflineWithFeedback pendingAction={policy?.pendingFields?.customRules}>
                             <MenuItemWithTopDescription
                                 title={policy?.customRules ?? ''}
@@ -771,7 +871,7 @@ function WorkspaceOverviewPage({policyDraft, policy: policyProp, route}: Workspa
                                 sentryLabel={CONST.SENTRY_LABEL.WORKSPACE.OVERVIEW.CUSTOM_RULES}
                                 shouldShowRightIcon={!readOnly}
                                 interactive={!readOnly}
-                                wrapperStyle={styles.sectionMenuItemTopDescription}
+                                wrapperStyle={[styles.sectionMenuItemTopDescription, styles.mt4]}
                                 onPress={() => Navigation.navigate(ROUTES.RULES_CUSTOM.getRoute(route.params.policyID))}
                                 shouldRenderAsHTML
                             />
diff --git a/src/types/onyx/Policy.ts b/src/types/onyx/Policy.ts
index c1b6ddcf64f1..fe8d2359f0bc 100644
--- a/src/types/onyx/Policy.ts
+++ b/src/types/onyx/Policy.ts
@@ -2007,6 +2007,9 @@ type Policy = OnyxCommon.OnyxValueWithOfflineFeedback<
         /** A set of custom rules defined with natural language */
         customRules?: string;
 
+        /** URL of the workspace rules PDF document stored in a private S3 bucket */
+        policyDocumentURL?: string;
+
         /** ReportID of the admins room for this workspace - This should be a string, we are keeping the number for backward compatibility */
         chatReportIDAdmins?: string | number;
 

From c1d9b252d64572870648ab3d740f37466545d8b4 Mon Sep 17 00:00:00 2001
From: Ishpaul Singh <ishpaul207@gmail.com>
Date: Sat, 11 Apr 2026 05:54:12 +0530
Subject: [PATCH 02/16] Use cacheBuster param name for policy document URL
 uniqueness

---
 src/libs/PolicyUtils.ts | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/src/libs/PolicyUtils.ts b/src/libs/PolicyUtils.ts
index 6ad6b60bb0f7..d3cff5594308 100644
--- a/src/libs/PolicyUtils.ts
+++ b/src/libs/PolicyUtils.ts
@@ -2172,7 +2172,9 @@ function getPolicyDocumentSourceURL(policyDocumentURL: string | undefined, polic
     }
 
     return addEncryptedAuthTokenToURL(
-        `${getApiRoot({shouldUseSecure: false})}api/GetPolicyDocument?policyID=${policyID}&v=${encodeURIComponent(policyDocumentURL)}`,
+        // Each PDF upload gets a unique S3 key, so policyDocumentURL changes on every replacement.
+        // Encoding it as cacheBuster ensures the full streaming URL is also unique, preventing stale browser/pdfjs cache.
+        `${getApiRoot({shouldUseSecure: false})}api/GetPolicyDocument?policyID=${policyID}&cacheBuster=${encodeURIComponent(policyDocumentURL)}`,
         encryptedAuthToken,
         true,
     );

From 3289b24184a03b4c4e6c8fac969f10779a0e60e7 Mon Sep 17 00:00:00 2001
From: Ishpaul Singh <ishpaul207@gmail.com>
Date: Tue, 14 Apr 2026 02:48:48 +0530
Subject: [PATCH 03/16] Rename policyDocumentURL to rulesDocumentURL, align API
 commands
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Rename field: policyDocumentURL → rulesDocumentURL across types,
  actions, utils, and pages
- Rename API commands: UpdatePolicyRulesDocument, DeletePolicyRulesDocument
- Rename param types and files to match
- Rename utility: getPolicyDocumentSourceURL → getRulesDocumentSourceURL
---
 .../DeletePolicyRulesDocumentParams.ts        |  5 +++
 .../DeleteWorkspaceRulesDocumentParams.ts     |  5 ---
 .../UpdatePolicyRulesDocumentParams.ts        |  6 ++++
 .../UpdateWorkspaceRulesDocumentParams.ts     |  6 ----
 src/libs/API/parameters/index.ts              |  4 +--
 src/libs/API/types.ts                         |  8 ++---
 src/libs/PolicyUtils.ts                       | 14 ++++----
 src/libs/actions/Policy/Policy.ts             | 36 +++++++++----------
 .../routes/WorkspaceDocumentModalContent.tsx  | 14 ++++----
 src/pages/workspace/WorkspaceOverviewPage.tsx | 22 ++++++------
 src/types/onyx/Policy.ts                      |  2 +-
 11 files changed, 61 insertions(+), 61 deletions(-)
 create mode 100644 src/libs/API/parameters/DeletePolicyRulesDocumentParams.ts
 delete mode 100644 src/libs/API/parameters/DeleteWorkspaceRulesDocumentParams.ts
 create mode 100644 src/libs/API/parameters/UpdatePolicyRulesDocumentParams.ts
 delete mode 100644 src/libs/API/parameters/UpdateWorkspaceRulesDocumentParams.ts

diff --git a/src/libs/API/parameters/DeletePolicyRulesDocumentParams.ts b/src/libs/API/parameters/DeletePolicyRulesDocumentParams.ts
new file mode 100644
index 000000000000..8b51b7a37f0e
--- /dev/null
+++ b/src/libs/API/parameters/DeletePolicyRulesDocumentParams.ts
@@ -0,0 +1,5 @@
+type DeletePolicyRulesDocumentParams = {
+    policyID: string;
+};
+
+export default DeletePolicyRulesDocumentParams;
diff --git a/src/libs/API/parameters/DeleteWorkspaceRulesDocumentParams.ts b/src/libs/API/parameters/DeleteWorkspaceRulesDocumentParams.ts
deleted file mode 100644
index 1cff382e8b76..000000000000
--- a/src/libs/API/parameters/DeleteWorkspaceRulesDocumentParams.ts
+++ /dev/null
@@ -1,5 +0,0 @@
-type DeleteWorkspaceRulesDocumentParams = {
-    policyID: string;
-};
-
-export default DeleteWorkspaceRulesDocumentParams;
diff --git a/src/libs/API/parameters/UpdatePolicyRulesDocumentParams.ts b/src/libs/API/parameters/UpdatePolicyRulesDocumentParams.ts
new file mode 100644
index 000000000000..c2a0873283df
--- /dev/null
+++ b/src/libs/API/parameters/UpdatePolicyRulesDocumentParams.ts
@@ -0,0 +1,6 @@
+type UpdatePolicyRulesDocumentParams = {
+    policyID: string;
+    file: File;
+};
+
+export default UpdatePolicyRulesDocumentParams;
diff --git a/src/libs/API/parameters/UpdateWorkspaceRulesDocumentParams.ts b/src/libs/API/parameters/UpdateWorkspaceRulesDocumentParams.ts
deleted file mode 100644
index 8539b6dfda84..000000000000
--- a/src/libs/API/parameters/UpdateWorkspaceRulesDocumentParams.ts
+++ /dev/null
@@ -1,6 +0,0 @@
-type UpdateWorkspaceRulesDocumentParams = {
-    policyID: string;
-    file: File;
-};
-
-export default UpdateWorkspaceRulesDocumentParams;
diff --git a/src/libs/API/parameters/index.ts b/src/libs/API/parameters/index.ts
index f9477e819f10..120a7e1081e9 100644
--- a/src/libs/API/parameters/index.ts
+++ b/src/libs/API/parameters/index.ts
@@ -164,8 +164,8 @@ export type {default as CreateWorkspaceParams} from './CreateWorkspaceParams';
 export type {default as UpdateWorkspaceGeneralSettingsParams} from './UpdateWorkspaceGeneralSettingsParams';
 export type {default as DeleteWorkspaceAvatarParams} from './DeleteWorkspaceAvatarParams';
 export type {default as UpdateWorkspaceAvatarParams} from './UpdateWorkspaceAvatarParams';
-export type {default as UpdateWorkspaceRulesDocumentParams} from './UpdateWorkspaceRulesDocumentParams';
-export type {default as DeleteWorkspaceRulesDocumentParams} from './DeleteWorkspaceRulesDocumentParams';
+export type {default as UpdatePolicyRulesDocumentParams} from './UpdatePolicyRulesDocumentParams';
+export type {default as DeletePolicyRulesDocumentParams} from './DeletePolicyRulesDocumentParams';
 export type {default as AddMembersToWorkspaceParams} from './AddMembersToWorkspaceParams';
 export type {default as DeleteMembersFromWorkspaceParams} from './DeleteMembersFromWorkspaceParams';
 export type {default as OpenWorkspaceParams} from './OpenWorkspaceParams';
diff --git a/src/libs/API/types.ts b/src/libs/API/types.ts
index 592c39eedcea..7fb02a715cd7 100644
--- a/src/libs/API/types.ts
+++ b/src/libs/API/types.ts
@@ -154,8 +154,8 @@ const WRITE_COMMANDS = {
     ADD_MEMBERS_TO_WORKSPACE: 'AddMembersToWorkspace',
     UPDATE_WORKSPACE_AVATAR: 'UpdateWorkspaceAvatar',
     DELETE_WORKSPACE_AVATAR: 'DeleteWorkspaceAvatar',
-    UPDATE_WORKSPACE_RULES_DOCUMENT: 'UpdateWorkspaceRulesDocument',
-    DELETE_WORKSPACE_RULES_DOCUMENT: 'DeleteWorkspaceRulesDocument',
+    UPDATE_POLICY_RULES_DOCUMENT: 'UpdatePolicyRulesDocument',
+    DELETE_POLICY_RULES_DOCUMENT: 'DeletePolicyRulesDocument',
     UPDATE_WORKSPACE_GENERAL_SETTINGS: 'UpdateWorkspaceGeneralSettings',
     UPDATE_WORKSPACE_DESCRIPTION: 'UpdateWorkspaceDescription',
     UPDATE_WORKSPACE_CLIENT_ID: 'UpdateWorkspaceClientID',
@@ -728,8 +728,8 @@ type WriteCommandParameters = {
     [WRITE_COMMANDS.ADD_MEMBERS_TO_WORKSPACE]: Parameters.AddMembersToWorkspaceParams;
     [WRITE_COMMANDS.UPDATE_WORKSPACE_AVATAR]: Parameters.UpdateWorkspaceAvatarParams;
     [WRITE_COMMANDS.DELETE_WORKSPACE_AVATAR]: Parameters.DeleteWorkspaceAvatarParams;
-    [WRITE_COMMANDS.UPDATE_WORKSPACE_RULES_DOCUMENT]: Parameters.UpdateWorkspaceRulesDocumentParams;
-    [WRITE_COMMANDS.DELETE_WORKSPACE_RULES_DOCUMENT]: Parameters.DeleteWorkspaceRulesDocumentParams;
+    [WRITE_COMMANDS.UPDATE_POLICY_RULES_DOCUMENT]: Parameters.UpdatePolicyRulesDocumentParams;
+    [WRITE_COMMANDS.DELETE_POLICY_RULES_DOCUMENT]: Parameters.DeletePolicyRulesDocumentParams;
     [WRITE_COMMANDS.UPDATE_WORKSPACE_GENERAL_SETTINGS]: Parameters.UpdateWorkspaceGeneralSettingsParams;
     [WRITE_COMMANDS.UPDATE_WORKSPACE_DESCRIPTION]: Parameters.UpdateWorkspaceDescriptionParams;
     [WRITE_COMMANDS.UPDATE_WORKSPACE_CLIENT_ID]: Parameters.UpdateWorkspaceClientIDParams;
diff --git a/src/libs/PolicyUtils.ts b/src/libs/PolicyUtils.ts
index d3cff5594308..0fe6e81e6ee1 100644
--- a/src/libs/PolicyUtils.ts
+++ b/src/libs/PolicyUtils.ts
@@ -2161,20 +2161,20 @@ function sortPoliciesByName(policies: Policy[], localeCompare: (a: string, b: st
  * The stored URL (which contains a unique timestamp per upload) is appended as a version
  * parameter so the browser treats each replacement as a distinct resource.
  */
-function getPolicyDocumentSourceURL(policyDocumentURL: string | undefined, policyID: string | undefined, encryptedAuthToken: string): string {
-    if (!policyDocumentURL || !policyID) {
+function getRulesDocumentSourceURL(rulesDocumentURL: string | undefined, policyID: string | undefined, encryptedAuthToken: string): string {
+    if (!rulesDocumentURL || !policyID) {
         return '';
     }
 
-    const isLocalFile = policyDocumentURL.startsWith('blob:') || policyDocumentURL.startsWith('file:');
+    const isLocalFile = rulesDocumentURL.startsWith('blob:') || rulesDocumentURL.startsWith('file:');
     if (isLocalFile) {
-        return policyDocumentURL;
+        return rulesDocumentURL;
     }
 
     return addEncryptedAuthTokenToURL(
-        // Each PDF upload gets a unique S3 key, so policyDocumentURL changes on every replacement.
+        // Each PDF upload gets a unique S3 key, so rulesDocumentURL changes on every replacement.
         // Encoding it as cacheBuster ensures the full streaming URL is also unique, preventing stale browser/pdfjs cache.
-        `${getApiRoot({shouldUseSecure: false})}api/GetPolicyDocument?policyID=${policyID}&cacheBuster=${encodeURIComponent(policyDocumentURL)}`,
+        `${getApiRoot({shouldUseSecure: false})}api/GetPolicyDocument?policyID=${policyID}&cacheBuster=${encodeURIComponent(rulesDocumentURL)}`,
         encryptedAuthToken,
         true,
     );
@@ -2363,7 +2363,7 @@ export {
     isPolicyTaxEnabled,
     sortPoliciesByName,
     isPolicyApprover,
-    getPolicyDocumentSourceURL,
+    getRulesDocumentSourceURL,
 };
 
 export type {MemberEmailsToAccountIDs};
diff --git a/src/libs/actions/Policy/Policy.ts b/src/libs/actions/Policy/Policy.ts
index 9cbe265a643e..9f4f728fe54b 100644
--- a/src/libs/actions/Policy/Policy.ts
+++ b/src/libs/actions/Policy/Policy.ts
@@ -14,9 +14,9 @@ import type {
     ChangePolicyUberBillingAccountPageParams,
     CreateWorkspaceFromIOUPaymentParams,
     CreateWorkspaceParams,
+    DeletePolicyRulesDocumentParams,
     DeleteWorkspaceAvatarParams,
     DeleteWorkspaceParams,
-    DeleteWorkspaceRulesDocumentParams,
     DisablePolicyApprovalsParams,
     DisablePolicyBillableModeParams,
     DowngradeToTeamParams,
@@ -68,11 +68,11 @@ import type {
     UpdateInvoiceCompanyNameParams,
     UpdateInvoiceCompanyWebsiteParams,
     UpdatePolicyAddressParams,
+    UpdatePolicyRulesDocumentParams,
     UpdateWorkspaceAvatarParams,
     UpdateWorkspaceClientIDParams,
     UpdateWorkspaceDescriptionParams,
     UpdateWorkspaceGeneralSettingsParams,
-    UpdateWorkspaceRulesDocumentParams,
     UpgradeToCorporateParams,
 } from '@libs/API/parameters';
 import type SetPolicyCashExpenseModeParams from '@libs/API/parameters/SetPolicyCashExpenseModeParams';
@@ -1813,12 +1813,12 @@ function updateWorkspaceRulesDocument(policyID: string, file: File, currentDocum
             onyxMethod: Onyx.METHOD.MERGE,
             key: `${ONYXKEYS.COLLECTION.POLICY}${policyID}`,
             value: {
-                policyDocumentURL: file.uri,
+                rulesDocumentURL: file.uri,
                 errorFields: {
-                    policyDocumentURL: null,
+                    rulesDocumentURL: null,
                 },
                 pendingFields: {
-                    policyDocumentURL: CONST.RED_BRICK_ROAD_PENDING_ACTION.UPDATE,
+                    rulesDocumentURL: CONST.RED_BRICK_ROAD_PENDING_ACTION.UPDATE,
                 },
             },
         },
@@ -1829,7 +1829,7 @@ function updateWorkspaceRulesDocument(policyID: string, file: File, currentDocum
             key: `${ONYXKEYS.COLLECTION.POLICY}${policyID}`,
             value: {
                 pendingFields: {
-                    policyDocumentURL: null,
+                    rulesDocumentURL: null,
                 },
             },
         },
@@ -1839,18 +1839,18 @@ function updateWorkspaceRulesDocument(policyID: string, file: File, currentDocum
             onyxMethod: Onyx.METHOD.MERGE,
             key: `${ONYXKEYS.COLLECTION.POLICY}${policyID}`,
             value: {
-                policyDocumentURL: currentDocumentURL ?? '',
-                errorFields: {policyDocumentURL: ErrorUtils.getMicroSecondOnyxErrorWithTranslationKey('common.genericErrorMessage')},
+                rulesDocumentURL: currentDocumentURL ?? '',
+                errorFields: {rulesDocumentURL: ErrorUtils.getMicroSecondOnyxErrorWithTranslationKey('common.genericErrorMessage')},
             },
         },
     ];
 
-    const params: UpdateWorkspaceRulesDocumentParams = {
+    const params: UpdatePolicyRulesDocumentParams = {
         policyID,
         file,
     };
 
-    API.write(WRITE_COMMANDS.UPDATE_WORKSPACE_RULES_DOCUMENT, params, {optimisticData, finallyData, failureData});
+    API.write(WRITE_COMMANDS.UPDATE_POLICY_RULES_DOCUMENT, params, {optimisticData, finallyData, failureData});
 }
 
 function deleteWorkspaceRulesDocument(policyID: string, currentDocumentURL: string) {
@@ -1859,12 +1859,12 @@ function deleteWorkspaceRulesDocument(policyID: string, currentDocumentURL: stri
             onyxMethod: Onyx.METHOD.MERGE,
             key: `${ONYXKEYS.COLLECTION.POLICY}${policyID}`,
             value: {
-                policyDocumentURL: '',
+                rulesDocumentURL: '',
                 errorFields: {
-                    policyDocumentURL: null,
+                    rulesDocumentURL: null,
                 },
                 pendingFields: {
-                    policyDocumentURL: CONST.RED_BRICK_ROAD_PENDING_ACTION.UPDATE,
+                    rulesDocumentURL: CONST.RED_BRICK_ROAD_PENDING_ACTION.UPDATE,
                 },
             },
         },
@@ -1875,7 +1875,7 @@ function deleteWorkspaceRulesDocument(policyID: string, currentDocumentURL: stri
             key: `${ONYXKEYS.COLLECTION.POLICY}${policyID}`,
             value: {
                 pendingFields: {
-                    policyDocumentURL: null,
+                    rulesDocumentURL: null,
                 },
             },
         },
@@ -1885,15 +1885,15 @@ function deleteWorkspaceRulesDocument(policyID: string, currentDocumentURL: stri
             onyxMethod: Onyx.METHOD.MERGE,
             key: `${ONYXKEYS.COLLECTION.POLICY}${policyID}`,
             value: {
-                policyDocumentURL: currentDocumentURL,
-                errorFields: {policyDocumentURL: ErrorUtils.getMicroSecondOnyxErrorWithTranslationKey('common.genericErrorMessage')},
+                rulesDocumentURL: currentDocumentURL,
+                errorFields: {rulesDocumentURL: ErrorUtils.getMicroSecondOnyxErrorWithTranslationKey('common.genericErrorMessage')},
             },
         },
     ];
 
-    const params: DeleteWorkspaceRulesDocumentParams = {policyID};
+    const params: DeletePolicyRulesDocumentParams = {policyID};
 
-    API.write(WRITE_COMMANDS.DELETE_WORKSPACE_RULES_DOCUMENT, params, {optimisticData, finallyData, failureData});
+    API.write(WRITE_COMMANDS.DELETE_POLICY_RULES_DOCUMENT, params, {optimisticData, finallyData, failureData});
 }
 
 /**
diff --git a/src/pages/media/AttachmentModalScreen/routes/WorkspaceDocumentModalContent.tsx b/src/pages/media/AttachmentModalScreen/routes/WorkspaceDocumentModalContent.tsx
index 892a060c7370..30e6d95ac1e7 100644
--- a/src/pages/media/AttachmentModalScreen/routes/WorkspaceDocumentModalContent.tsx
+++ b/src/pages/media/AttachmentModalScreen/routes/WorkspaceDocumentModalContent.tsx
@@ -1,7 +1,7 @@
 import React, {useMemo} from 'react';
 import useOnyx from '@hooks/useOnyx';
 import usePolicy from '@hooks/usePolicy';
-import {getPolicyDocumentSourceURL} from '@libs/PolicyUtils';
+import {getRulesDocumentSourceURL} from '@libs/PolicyUtils';
 import type {AttachmentModalBaseContentProps} from '@pages/media/AttachmentModalScreen/AttachmentModalBaseContent/types';
 import AttachmentModalContainer from '@pages/media/AttachmentModalScreen/AttachmentModalContainer';
 import type {AttachmentModalScreenProps} from '@pages/media/AttachmentModalScreen/types';
@@ -18,24 +18,24 @@ function WorkspaceDocumentModalContent({navigation, route}: AttachmentModalScree
     const policyKeysLength = Object.keys(policy ?? {}).length;
 
     // eslint-disable-next-line rulesdir/no-negated-variables
-    const shouldShowNotFoundPage = (policyKeysLength === 0 && !isLoadingApp) || !policy?.policyDocumentURL;
+    const shouldShowNotFoundPage = (policyKeysLength === 0 && !isLoadingApp) || !policy?.rulesDocumentURL;
     const isLoading = policyKeysLength === 0 && !!isLoadingApp;
 
-    const policyDocumentSourceURL = useMemo(
-        () => getPolicyDocumentSourceURL(policy?.policyDocumentURL, policyID, session?.encryptedAuthToken ?? ''),
-        [policy?.policyDocumentURL, policyID, session?.encryptedAuthToken],
+    const rulesDocumentSourceURL = useMemo(
+        () => getRulesDocumentSourceURL(policy?.rulesDocumentURL, policyID, session?.encryptedAuthToken ?? ''),
+        [policy?.rulesDocumentURL, policyID, session?.encryptedAuthToken],
     );
 
     const contentProps = useMemo<AttachmentModalBaseContentProps>(
         () => ({
-            source: policyDocumentSourceURL,
+            source: rulesDocumentSourceURL,
             headerTitle: policy?.name ?? '',
             originalFileName: `${policyID}-policy-document.pdf`,
             shouldShowNotFoundPage,
             isLoading,
             shouldCloseOnSwipeDown: true,
         }),
-        [policyDocumentSourceURL, policy?.name, policyID, shouldShowNotFoundPage, isLoading],
+        [rulesDocumentSourceURL, policy?.name, policyID, shouldShowNotFoundPage, isLoading],
     );
 
     return (
diff --git a/src/pages/workspace/WorkspaceOverviewPage.tsx b/src/pages/workspace/WorkspaceOverviewPage.tsx
index c5367aa9bfb6..e3947e851037 100644
--- a/src/pages/workspace/WorkspaceOverviewPage.tsx
+++ b/src/pages/workspace/WorkspaceOverviewPage.tsx
@@ -62,7 +62,7 @@ import type {PlatformStackScreenProps} from '@libs/Navigation/PlatformStackNavig
 import type {WorkspaceSplitNavigatorParamList} from '@libs/Navigation/types';
 import {
     getConnectionExporters,
-    getPolicyDocumentSourceURL,
+    getRulesDocumentSourceURL,
     getUserFriendlyWorkspaceType,
     goBackFromInvalidPolicy,
     isPendingDeletePolicy,
@@ -196,9 +196,9 @@ function WorkspaceOverviewPage({policyDraft, policy: policyProp, route}: Workspa
     const [isLeaveModalOpen, setIsLeaveModalOpen] = useState(false);
     const [session] = useOnyx(ONYXKEYS.SESSION);
 
-    const policyDocumentSourceURL = useMemo(
-        () => getPolicyDocumentSourceURL(policy?.policyDocumentURL, policyID, session?.encryptedAuthToken ?? ''),
-        [policy?.policyDocumentURL, policyID, session?.encryptedAuthToken],
+    const rulesDocumentSourceURL = useMemo(
+        () => getRulesDocumentSourceURL(policy?.rulesDocumentURL, policyID, session?.encryptedAuthToken ?? ''),
+        [policy?.rulesDocumentURL, policyID, session?.encryptedAuthToken],
     );
 
     const personalDetails = usePersonalDetails();
@@ -449,7 +449,7 @@ function WorkspaceOverviewPage({policyDraft, policy: policyProp, route}: Workspa
                         if (!policyID || !files.length) {
                             return;
                         }
-                        updateWorkspaceRulesDocument(policyID, files.at(0) as File, policy?.policyDocumentURL);
+                        updateWorkspaceRulesDocument(policyID, files.at(0) as File, policy?.rulesDocumentURL);
                     },
                 });
             },
@@ -458,10 +458,10 @@ function WorkspaceOverviewPage({policyDraft, policy: policyProp, route}: Workspa
             text: translate('common.remove'),
             icon: expensifyIcons.Trashcan,
             onSelected: () => {
-                if (!policyID || !policy?.policyDocumentURL) {
+                if (!policyID || !policy?.rulesDocumentURL) {
                     return;
                 }
-                deleteWorkspaceRulesDocument(policyID, policy.policyDocumentURL);
+                deleteWorkspaceRulesDocument(policyID, policy.rulesDocumentURL);
             },
         },
     ];
@@ -807,11 +807,11 @@ function WorkspaceOverviewPage({policyDraft, policy: policyProp, route}: Workspa
                         subtitleTextStyles={[styles.textNormal, styles.colorMuted, styles.mr5]}
                         containerStyles={shouldUseNarrowLayout ? styles.p5 : styles.p8}
                     >
-                        <OfflineWithFeedback pendingAction={policy?.pendingFields?.policyDocumentURL}>
+                        <OfflineWithFeedback pendingAction={policy?.pendingFields?.rulesDocumentURL}>
                             <Text style={[styles.mutedTextLabel, styles.mb2]}>{translate('workspace.rules.customRules.policyDocument')}</Text>
                             <AttachmentPicker acceptedFileTypes={['pdf']}>
                                 {({openPicker}) => {
-                                    if (policy?.policyDocumentURL) {
+                                    if (policy?.rulesDocumentURL) {
                                         return (
                                             <View style={[styles.flexRow, styles.alignItemsStart]}>
                                                 <PressableWithoutFeedback
@@ -826,7 +826,7 @@ function WorkspaceOverviewPage({policyDraft, policy: policyProp, route}: Workspa
                                                     style={[styles.border, styles.borderRadiusComponentLarge, styles.overflowHidden, {width: 200, height: 260}]}
                                                 >
                                                     <PDFThumbnail
-                                                        previewSourceURL={policyDocumentSourceURL}
+                                                        previewSourceURL={rulesDocumentSourceURL}
                                                         style={{width: 200, height: 260}}
                                                     />
                                                 </PressableWithoutFeedback>
@@ -854,7 +854,7 @@ function WorkspaceOverviewPage({policyDraft, policy: policyProp, route}: Workspa
                                                         if (!policyID || !files.length) {
                                                             return;
                                                         }
-                                                        updateWorkspaceRulesDocument(policyID, files.at(0) as File, policy?.policyDocumentURL);
+                                                        updateWorkspaceRulesDocument(policyID, files.at(0) as File, policy?.rulesDocumentURL);
                                                     },
                                                 });
                                             }}
diff --git a/src/types/onyx/Policy.ts b/src/types/onyx/Policy.ts
index fe8d2359f0bc..6e73a8a3ce95 100644
--- a/src/types/onyx/Policy.ts
+++ b/src/types/onyx/Policy.ts
@@ -2008,7 +2008,7 @@ type Policy = OnyxCommon.OnyxValueWithOfflineFeedback<
         customRules?: string;
 
         /** URL of the workspace rules PDF document stored in a private S3 bucket */
-        policyDocumentURL?: string;
+        rulesDocumentURL?: string;
 
         /** ReportID of the admins room for this workspace - This should be a string, we are keeping the number for backward compatibility */
         chatReportIDAdmins?: string | number;

From 7f4d8e61f0422b59ffd308b7b2bb2e0ac64104c6 Mon Sep 17 00:00:00 2001
From: Ishpaul Singh <ishpaul207@gmail.com>
Date: Wed, 15 Apr 2026 23:45:37 +0530
Subject: [PATCH 04/16] Rename action functions to align with API command names

Renamed updateWorkspaceRulesDocument -> updatePolicyRulesDocument and
deleteWorkspaceRulesDocument -> deletePolicyRulesDocument. Updated
GetPolicyDocument -> GetPolicyRulesDocument streaming endpoint.
---
 src/libs/PolicyUtils.ts           | 4 ++--
 src/libs/actions/Policy/Policy.ts | 8 ++++----
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/src/libs/PolicyUtils.ts b/src/libs/PolicyUtils.ts
index 0fe6e81e6ee1..d1237035dbb1 100644
--- a/src/libs/PolicyUtils.ts
+++ b/src/libs/PolicyUtils.ts
@@ -2157,7 +2157,7 @@ function sortPoliciesByName(policies: Policy[], localeCompare: (a: string, b: st
 /**
  * Builds a source URL for rendering a policy document PDF.
  * Local blob/file URIs (from optimistic uploads) are returned directly.
- * Remote URLs are routed through the authenticated GetPolicyDocument streaming endpoint.
+ * Remote URLs are routed through the authenticated GetPolicyRulesDocument streaming endpoint.
  * The stored URL (which contains a unique timestamp per upload) is appended as a version
  * parameter so the browser treats each replacement as a distinct resource.
  */
@@ -2174,7 +2174,7 @@ function getRulesDocumentSourceURL(rulesDocumentURL: string | undefined, policyI
     return addEncryptedAuthTokenToURL(
         // Each PDF upload gets a unique S3 key, so rulesDocumentURL changes on every replacement.
         // Encoding it as cacheBuster ensures the full streaming URL is also unique, preventing stale browser/pdfjs cache.
-        `${getApiRoot({shouldUseSecure: false})}api/GetPolicyDocument?policyID=${policyID}&cacheBuster=${encodeURIComponent(rulesDocumentURL)}`,
+        `${getApiRoot({shouldUseSecure: false})}api/GetPolicyRulesDocument?policyID=${policyID}&cacheBuster=${encodeURIComponent(rulesDocumentURL)}`,
         encryptedAuthToken,
         true,
     );
diff --git a/src/libs/actions/Policy/Policy.ts b/src/libs/actions/Policy/Policy.ts
index 9f4f728fe54b..afa14482cfd6 100644
--- a/src/libs/actions/Policy/Policy.ts
+++ b/src/libs/actions/Policy/Policy.ts
@@ -1807,7 +1807,7 @@ function deleteWorkspaceAvatar(policyID: string, currentAvatarURL: string, curre
     API.write(WRITE_COMMANDS.DELETE_WORKSPACE_AVATAR, params, {optimisticData, finallyData, failureData});
 }
 
-function updateWorkspaceRulesDocument(policyID: string, file: File, currentDocumentURL: string | undefined) {
+function updatePolicyRulesDocument(policyID: string, file: File, currentDocumentURL: string | undefined) {
     const optimisticData: Array<OnyxUpdate<typeof ONYXKEYS.COLLECTION.POLICY>> = [
         {
             onyxMethod: Onyx.METHOD.MERGE,
@@ -1853,7 +1853,7 @@ function updateWorkspaceRulesDocument(policyID: string, file: File, currentDocum
     API.write(WRITE_COMMANDS.UPDATE_POLICY_RULES_DOCUMENT, params, {optimisticData, finallyData, failureData});
 }
 
-function deleteWorkspaceRulesDocument(policyID: string, currentDocumentURL: string) {
+function deletePolicyRulesDocument(policyID: string, currentDocumentURL: string) {
     const optimisticData: Array<OnyxUpdate<typeof ONYXKEYS.COLLECTION.POLICY>> = [
         {
             onyxMethod: Onyx.METHOD.MERGE,
@@ -7206,8 +7206,8 @@ export {
     updateGeneralSettings,
     deleteWorkspaceAvatar,
     updateWorkspaceAvatar,
-    updateWorkspaceRulesDocument,
-    deleteWorkspaceRulesDocument,
+    updatePolicyRulesDocument,
+    deletePolicyRulesDocument,
     clearAvatarErrors,
     generatePolicyID,
     createWorkspace,

From 3aa5f75d837ad6bcf57d44c4d9137f61bac92eef Mon Sep 17 00:00:00 2001
From: Ishpaul Singh <ishpaul207@gmail.com>
Date: Wed, 15 Apr 2026 23:45:44 +0530
Subject: [PATCH 05/16] Fix thumbnail styling, three-dots menu, and add
 translation keys

- Add policyDocument and policyText translation keys to all locales
- Use named constants for thumbnail dimensions instead of magic numbers
- Position three-dots menu on thumbnail with circular background
- Wrap Choose file button to prevent full-width stretch
- Use policyText label for custom rules text field
---
 src/languages/en.ts                           |  2 +
 src/languages/pt-BR.ts                        |  2 +
 src/languages/zh-hans.ts                      |  2 +
 src/pages/workspace/WorkspaceOverviewPage.tsx | 62 +++++++++++--------
 src/styles/variables.ts                       |  2 +
 5 files changed, 43 insertions(+), 27 deletions(-)

diff --git a/src/languages/en.ts b/src/languages/en.ts
index dbbff738185c..d6ebad040c6f 100644
--- a/src/languages/en.ts
+++ b/src/languages/en.ts
@@ -6852,6 +6852,8 @@ const translations = {
             customRules: {
                 title: 'Expense policy',
                 cardSubtitle: "Here's where your team's expense policy lives, so everyone's on the same page about what's covered.",
+                policyDocument: 'Policy document',
+                policyText: 'Policy text',
             },
             spendRules: {
                 title: 'Spend',
diff --git a/src/languages/pt-BR.ts b/src/languages/pt-BR.ts
index 9748e798c947..6e1735e5b345 100644
--- a/src/languages/pt-BR.ts
+++ b/src/languages/pt-BR.ts
@@ -6801,6 +6801,8 @@ Exija dados de despesas como recibos e descrições, defina limites e padrões e
             customRules: {
                 title: 'Política de despesas',
                 cardSubtitle: 'Aqui é onde fica a política de despesas da sua equipe, para que todo mundo esteja alinhado sobre o que é coberto.',
+                policyDocument: 'Documento de política',
+                policyText: 'Texto da política',
             },
             spendRules: {
                 title: 'Gasto',
diff --git a/src/languages/zh-hans.ts b/src/languages/zh-hans.ts
index a4ece4aef055..6642f3d95275 100644
--- a/src/languages/zh-hans.ts
+++ b/src/languages/zh-hans.ts
@@ -6628,6 +6628,8 @@ ${reportName}
             customRules: {
                 title: '报销政策',
                 cardSubtitle: '这是你们团队的报销政策所在之处，让所有人都清楚哪些内容在报销范围之内。',
+                policyDocument: '政策文件',
+                policyText: '政策文本',
             },
             spendRules: {
                 title: '支出',
diff --git a/src/pages/workspace/WorkspaceOverviewPage.tsx b/src/pages/workspace/WorkspaceOverviewPage.tsx
index e3947e851037..21f8616a1c42 100644
--- a/src/pages/workspace/WorkspaceOverviewPage.tsx
+++ b/src/pages/workspace/WorkspaceOverviewPage.tsx
@@ -35,6 +35,7 @@ import usePrevious from '@hooks/usePrevious';
 import usePrivateSubscription from '@hooks/usePrivateSubscription';
 import useResponsiveLayout from '@hooks/useResponsiveLayout';
 import useShouldBlockCurrencyChange from '@hooks/useShouldBlockCurrencyChange';
+import useTheme from '@hooks/useTheme';
 import useThemeStyles from '@hooks/useThemeStyles';
 import useTransactionViolationOfWorkspace from '@hooks/useTransactionViolationOfWorkspace';
 import useWorkspaceDocumentTitle from '@hooks/useWorkspaceDocumentTitle';
@@ -45,14 +46,14 @@ import {
     clearAvatarErrors,
     clearDeleteWorkspaceError,
     clearPolicyErrorField,
+    deletePolicyRulesDocument,
     deleteWorkspace,
     deleteWorkspaceAvatar,
-    deleteWorkspaceRulesDocument,
     leaveWorkspace,
     openPolicyProfilePage,
     setIsComingFromGlobalReimbursementsFlow,
+    updatePolicyRulesDocument,
     updateWorkspaceAvatar,
-    updateWorkspaceRulesDocument,
 } from '@libs/actions/Policy/Policy';
 import {filterInactiveCards, getCardSettings} from '@libs/CardUtils';
 import {getLatestErrorField, getLatestErrorMessage} from '@libs/ErrorUtils';
@@ -77,6 +78,7 @@ import {getDefaultWorkspaceAvatar} from '@libs/ReportUtils';
 import shouldRenderTransferOwnerButton from '@libs/shouldRenderTransferOwnerButton';
 import StringUtils from '@libs/StringUtils';
 import {isSubscriptionTypeOfInvoicing, shouldCalculateBillNewDot} from '@libs/SubscriptionUtils';
+import variables from '@styles/variables';
 import CONST from '@src/CONST';
 import ONYXKEYS from '@src/ONYXKEYS';
 import ROUTES, {DYNAMIC_ROUTES} from '@src/ROUTES';
@@ -93,6 +95,7 @@ import WorkspacePageWithSections from './WorkspacePageWithSections';
 type WorkspaceOverviewPageProps = WithPolicyProps & PlatformStackScreenProps<WorkspaceSplitNavigatorParamList, typeof SCREENS.WORKSPACE.PROFILE>;
 
 function WorkspaceOverviewPage({policyDraft, policy: policyProp, route}: WorkspaceOverviewPageProps) {
+    const theme = useTheme();
     const styles = useThemeStyles();
     const {translate, localeCompare} = useLocalize();
     const {shouldUseNarrowLayout} = useResponsiveLayout();
@@ -439,7 +442,7 @@ function WorkspaceOverviewPage({policyDraft, policy: policyProp, route}: Workspa
         return translate('common.leaveWorkspaceConfirmation');
     };
 
-    const getPolicyDocumentMenuItems = (openPicker: (options: {onPicked: (files: FileObject[]) => void}) => void): PopoverMenuItem[] => [
+    const getRulesDocumentMenuItems = (openPicker: (options: {onPicked: (files: FileObject[]) => void}) => void): PopoverMenuItem[] => [
         {
             text: translate('common.replace'),
             icon: expensifyIcons.Upload,
@@ -449,7 +452,7 @@ function WorkspaceOverviewPage({policyDraft, policy: policyProp, route}: Workspa
                         if (!policyID || !files.length) {
                             return;
                         }
-                        updateWorkspaceRulesDocument(policyID, files.at(0) as File, policy?.rulesDocumentURL);
+                        updatePolicyRulesDocument(policyID, files.at(0) as File, policy?.rulesDocumentURL);
                     },
                 });
             },
@@ -461,7 +464,7 @@ function WorkspaceOverviewPage({policyDraft, policy: policyProp, route}: Workspa
                 if (!policyID || !policy?.rulesDocumentURL) {
                     return;
                 }
-                deleteWorkspaceRulesDocument(policyID, policy.rulesDocumentURL);
+                deletePolicyRulesDocument(policyID, policy.rulesDocumentURL);
             },
         },
     ];
@@ -813,7 +816,7 @@ function WorkspaceOverviewPage({policyDraft, policy: policyProp, route}: Workspa
                                 {({openPicker}) => {
                                     if (policy?.rulesDocumentURL) {
                                         return (
-                                            <View style={[styles.flexRow, styles.alignItemsStart]}>
+                                            <View style={{width: variables.rulesDocumentThumbnailWidth, height: variables.rulesDocumentThumbnailHeight}}>
                                                 <PressableWithoutFeedback
                                                     onPress={() => {
                                                         if (!policyID) {
@@ -823,18 +826,21 @@ function WorkspaceOverviewPage({policyDraft, policy: policyProp, route}: Workspa
                                                     }}
                                                     role={CONST.ROLE.BUTTON}
                                                     accessibilityLabel={translate('workspace.rules.customRules.policyDocument')}
-                                                    style={[styles.border, styles.borderRadiusComponentLarge, styles.overflowHidden, {width: 200, height: 260}]}
+                                                    style={[styles.border, styles.borderRadiusComponentLarge, styles.overflowHidden, styles.flex1]}
                                                 >
                                                     <PDFThumbnail
                                                         previewSourceURL={rulesDocumentSourceURL}
-                                                        style={{width: 200, height: 260}}
+                                                        style={{width: variables.rulesDocumentThumbnailWidth, height: variables.rulesDocumentThumbnailHeight}}
                                                     />
                                                 </PressableWithoutFeedback>
                                                 {isPolicyAdmin && (
-                                                    <ThreeDotsMenu
-                                                        menuItems={getPolicyDocumentMenuItems(openPicker)}
-                                                        shouldSelfPosition
-                                                    />
+                                                    <View style={[styles.pAbsolute, {top: variables.spacing2, right: variables.spacing2}]}>
+                                                        <ThreeDotsMenu
+                                                            menuItems={getRulesDocumentMenuItems(openPicker)}
+                                                            shouldSelfPosition
+                                                            iconStyles={[{borderRadius: variables.componentSizeNormal / 2, backgroundColor: theme.cardBG}]}
+                                                        />
+                                                    </View>
                                                 )}
                                             </View>
                                         );
@@ -845,20 +851,22 @@ function WorkspaceOverviewPage({policyDraft, policy: policyProp, route}: Workspa
                                     }
 
                                     return (
-                                        <Button
-                                            medium
-                                            text={translate('common.chooseFile')}
-                                            onPress={() => {
-                                                openPicker({
-                                                    onPicked: (files) => {
-                                                        if (!policyID || !files.length) {
-                                                            return;
-                                                        }
-                                                        updateWorkspaceRulesDocument(policyID, files.at(0) as File, policy?.rulesDocumentURL);
-                                                    },
-                                                });
-                                            }}
-                                        />
+                                        <View style={[styles.flexRow]}>
+                                            <Button
+                                                medium
+                                                text={translate('common.chooseFile')}
+                                                onPress={() => {
+                                                    openPicker({
+                                                        onPicked: (files) => {
+                                                            if (!policyID || !files.length) {
+                                                                return;
+                                                            }
+                                                            updatePolicyRulesDocument(policyID, files.at(0) as File, policy?.rulesDocumentURL);
+                                                        },
+                                                    });
+                                                }}
+                                            />
+                                        </View>
                                     );
                                 }}
                             </AttachmentPicker>
@@ -867,7 +875,7 @@ function WorkspaceOverviewPage({policyDraft, policy: policyProp, route}: Workspa
                         <OfflineWithFeedback pendingAction={policy?.pendingFields?.customRules}>
                             <MenuItemWithTopDescription
                                 title={policy?.customRules ?? ''}
-                                description={translate('workspace.editor.policy')}
+                                description={translate('workspace.rules.customRules.policyText')}
                                 sentryLabel={CONST.SENTRY_LABEL.WORKSPACE.OVERVIEW.CUSTOM_RULES}
                                 shouldShowRightIcon={!readOnly}
                                 interactive={!readOnly}
diff --git a/src/styles/variables.ts b/src/styles/variables.ts
index 7b897e288fe6..9619cf4ba961 100644
--- a/src/styles/variables.ts
+++ b/src/styles/variables.ts
@@ -22,6 +22,8 @@ export default {
     inputComponentSizeNormal: 40,
     componentSizeLarge: 52,
     spacing2: 8,
+    rulesDocumentThumbnailWidth: 368,
+    rulesDocumentThumbnailHeight: 200,
     componentBorderRadius: 8,
     componentBorderRadiusSmall: 4,
     componentBorderRadiusMedium: 6,

From a9532c4dd4e350bfe6f669838ce1b04fdea397a9 Mon Sep 17 00:00:00 2001
From: Ishpaul Singh <ishpaul207@gmail.com>
Date: Wed, 15 Apr 2026 23:55:28 +0530
Subject: [PATCH 06/16] Fix CI: add translation keys to all locales, add
 sentryLabel

- Add policyDocument and policyText to es, fr, de, it, ja, nl, pl
- Add sentryLabel to PressableWithoutFeedback for PDF thumbnail
- Add RULES_DOCUMENT sentry label constant
---
 src/CONST/index.ts                            | 1 +
 src/languages/de.ts                           | 2 ++
 src/languages/es.ts                           | 2 ++
 src/languages/fr.ts                           | 2 ++
 src/languages/it.ts                           | 2 ++
 src/languages/ja.ts                           | 2 ++
 src/languages/nl.ts                           | 2 ++
 src/languages/pl.ts                           | 2 ++
 src/pages/workspace/WorkspaceOverviewPage.tsx | 1 +
 9 files changed, 16 insertions(+)

diff --git a/src/CONST/index.ts b/src/CONST/index.ts
index 5ece2222e909..c59d5120d080 100644
--- a/src/CONST/index.ts
+++ b/src/CONST/index.ts
@@ -9312,6 +9312,7 @@ const CONST = {
                 PLAN_TYPE: 'WorkspaceOverview-PlanType',
                 SHARE: 'WorkspaceOverview-Share',
                 CUSTOM_RULES: 'WorkspaceOverview-CustomRules',
+                RULES_DOCUMENT: 'WorkspaceOverview-RulesDocument',
                 INVITE_BUTTON: 'WorkspaceOverview-InviteButton',
                 MORE_DROPDOWN: 'WorkspaceOverview-MoreDropdown',
             },
diff --git a/src/languages/de.ts b/src/languages/de.ts
index 988c03fa66f5..e9b81087ee86 100644
--- a/src/languages/de.ts
+++ b/src/languages/de.ts
@@ -6838,6 +6838,8 @@ Fordern Sie Spesendetails wie Belege und Beschreibungen an, legen Sie Limits und
             customRules: {
                 title: 'Spesenrichtlinie',
                 cardSubtitle: 'Hier ist die Spesenrichtlinie deines Teams hinterlegt, damit alle denselben Stand haben, was abgedeckt ist.',
+                policyDocument: 'Richtliniendokument',
+                policyText: 'Richtlinientext',
             },
             spendRules: {
                 title: 'Ausgaben',
diff --git a/src/languages/es.ts b/src/languages/es.ts
index 9432bc7ad3ea..2614ce3d37c7 100644
--- a/src/languages/es.ts
+++ b/src/languages/es.ts
@@ -6739,6 +6739,8 @@ ${amount} para ${merchant} - ${date}`,
             customRules: {
                 title: 'Reglas personalizadas',
                 cardSubtitle: 'Aquí es donde se definen las reglas de tu equipo, para que todos sepan lo que esta cubierto.',
+                policyDocument: 'Documento de política',
+                policyText: 'Texto de política',
             },
             spendRules: {
                 title: 'Gastos',
diff --git a/src/languages/fr.ts b/src/languages/fr.ts
index f979a1f38d08..56186151785c 100644
--- a/src/languages/fr.ts
+++ b/src/languages/fr.ts
@@ -6860,6 +6860,8 @@ Rendez obligatoires des informations de dépense comme les reçus et les descrip
             customRules: {
                 title: 'Politique de dépenses',
                 cardSubtitle: 'C’est ici que se trouve la politique de dépenses de votre équipe, pour que tout le monde soit d’accord sur ce qui est couvert.',
+                policyDocument: 'Document de politique',
+                policyText: 'Texte de politique',
             },
             spendRules: {
                 title: 'Dépenser',
diff --git a/src/languages/it.ts b/src/languages/it.ts
index 81b7ebdca9e8..14fc3ba74266 100644
--- a/src/languages/it.ts
+++ b/src/languages/it.ts
@@ -6823,6 +6823,8 @@ Richiedi dettagli sulle spese come ricevute e descrizioni, imposta limiti e valo
             customRules: {
                 title: 'Politica di spesa',
                 cardSubtitle: 'Qui trovi il regolamento spese del tuo team, così tutti sono allineati su cosa è coperto.',
+                policyDocument: 'Documento di politica',
+                policyText: 'Testo della politica',
             },
             spendRules: {
                 title: 'Spesa',
diff --git a/src/languages/ja.ts b/src/languages/ja.ts
index 64954857cf36..c5f92212a192 100644
--- a/src/languages/ja.ts
+++ b/src/languages/ja.ts
@@ -6746,6 +6746,8 @@ ${reportName}
             customRules: {
                 title: '経費ポリシー',
                 cardSubtitle: 'ここはチームの経費ポリシーが保存されている場所です。何が対象になるか、全員が同じ認識を持てます。',
+                policyDocument: 'ポリシー文書',
+                policyText: 'ポリシーテキスト',
             },
             spendRules: {
                 title: '支出',
diff --git a/src/languages/nl.ts b/src/languages/nl.ts
index 85be4a6e6265..45df7854886a 100644
--- a/src/languages/nl.ts
+++ b/src/languages/nl.ts
@@ -6803,6 +6803,8 @@ Vereis onkostendetails zoals bonnen en beschrijvingen, stel limieten en standaar
             customRules: {
                 title: 'Declaratiebeleid',
                 cardSubtitle: 'Hier staat het declaratiebeleid van je team, zodat iedereen hetzelfde beeld heeft van wat er wordt vergoed.',
+                policyDocument: 'Beleidsdocument',
+                policyText: 'Beleidstekst',
             },
             spendRules: {
                 title: 'Uitgaven',
diff --git a/src/languages/pl.ts b/src/languages/pl.ts
index d94add2de226..b97dba8acd5a 100644
--- a/src/languages/pl.ts
+++ b/src/languages/pl.ts
@@ -6795,6 +6795,8 @@ Wymagaj szczegółów wydatków, takich jak paragony i opisy, ustawiaj limity i
             customRules: {
                 title: 'Polityka wydatków',
                 cardSubtitle: 'To tutaj znajduje się polityka wydatków Twojego zespołu, aby wszyscy mieli jasność co do tego, co jest objęte.',
+                policyDocument: 'Dokument polityki',
+                policyText: 'Tekst polityki',
             },
             spendRules: {
                 title: 'Wydatki',
diff --git a/src/pages/workspace/WorkspaceOverviewPage.tsx b/src/pages/workspace/WorkspaceOverviewPage.tsx
index 21f8616a1c42..de0b3a74732d 100644
--- a/src/pages/workspace/WorkspaceOverviewPage.tsx
+++ b/src/pages/workspace/WorkspaceOverviewPage.tsx
@@ -826,6 +826,7 @@ function WorkspaceOverviewPage({policyDraft, policy: policyProp, route}: Workspa
                                                     }}
                                                     role={CONST.ROLE.BUTTON}
                                                     accessibilityLabel={translate('workspace.rules.customRules.policyDocument')}
+                                                    sentryLabel={CONST.SENTRY_LABEL.WORKSPACE.OVERVIEW.RULES_DOCUMENT}
                                                     style={[styles.border, styles.borderRadiusComponentLarge, styles.overflowHidden, styles.flex1]}
                                                 >
                                                     <PDFThumbnail

From c6b5887b67d1c951c9d2912ae48fbe588b2cfdb9 Mon Sep 17 00:00:00 2001
From: Ishpaul Singh <ishpaul207@gmail.com>
Date: Thu, 16 Apr 2026 00:40:02 +0530
Subject: [PATCH 07/16] Memoize inline style objects for rules document
 thumbnail

Extract inline style objects for the PDF thumbnail container,
PDFThumbnail, ThreeDotsMenu position, and icon into useMemo
to avoid creating new references on every render.
---
 src/pages/workspace/WorkspaceOverviewPage.tsx | 12 ++++++++----
 1 file changed, 8 insertions(+), 4 deletions(-)

diff --git a/src/pages/workspace/WorkspaceOverviewPage.tsx b/src/pages/workspace/WorkspaceOverviewPage.tsx
index de0b3a74732d..a096101b2b2a 100644
--- a/src/pages/workspace/WorkspaceOverviewPage.tsx
+++ b/src/pages/workspace/WorkspaceOverviewPage.tsx
@@ -204,6 +204,10 @@ function WorkspaceOverviewPage({policyDraft, policy: policyProp, route}: Workspa
         [policy?.rulesDocumentURL, policyID, session?.encryptedAuthToken],
     );
 
+    const rulesDocumentThumbnailStyle = useMemo(() => ({width: variables.rulesDocumentThumbnailWidth, height: variables.rulesDocumentThumbnailHeight}), []);
+    const rulesDocumentMenuPositionStyle = useMemo(() => ({top: variables.spacing2, right: variables.spacing2}), []);
+    const rulesDocumentMenuIconStyle = useMemo(() => ({borderRadius: variables.componentSizeNormal / 2, backgroundColor: theme.cardBG}), [theme.cardBG]);
+
     const personalDetails = usePersonalDetails();
     const [accountIDToLogin] = useOnyx(ONYXKEYS.PERSONAL_DETAILS_LIST, {selector: accountIDToLoginSelector(reportsToArchive)});
     const [isCannotLeaveWorkspaceModalOpen, setIsCannotLeaveWorkspaceModalOpen] = useState(false);
@@ -816,7 +820,7 @@ function WorkspaceOverviewPage({policyDraft, policy: policyProp, route}: Workspa
                                 {({openPicker}) => {
                                     if (policy?.rulesDocumentURL) {
                                         return (
-                                            <View style={{width: variables.rulesDocumentThumbnailWidth, height: variables.rulesDocumentThumbnailHeight}}>
+                                            <View style={rulesDocumentThumbnailStyle}>
                                                 <PressableWithoutFeedback
                                                     onPress={() => {
                                                         if (!policyID) {
@@ -831,15 +835,15 @@ function WorkspaceOverviewPage({policyDraft, policy: policyProp, route}: Workspa
                                                 >
                                                     <PDFThumbnail
                                                         previewSourceURL={rulesDocumentSourceURL}
-                                                        style={{width: variables.rulesDocumentThumbnailWidth, height: variables.rulesDocumentThumbnailHeight}}
+                                                        style={rulesDocumentThumbnailStyle}
                                                     />
                                                 </PressableWithoutFeedback>
                                                 {isPolicyAdmin && (
-                                                    <View style={[styles.pAbsolute, {top: variables.spacing2, right: variables.spacing2}]}>
+                                                    <View style={[styles.pAbsolute, rulesDocumentMenuPositionStyle]}>
                                                         <ThreeDotsMenu
                                                             menuItems={getRulesDocumentMenuItems(openPicker)}
                                                             shouldSelfPosition
-                                                            iconStyles={[{borderRadius: variables.componentSizeNormal / 2, backgroundColor: theme.cardBG}]}
+                                                            iconStyles={[rulesDocumentMenuIconStyle]}
                                                         />
                                                     </View>
                                                 )}

From 9959723e2c64a9f171923f4e74c4529d218538da Mon Sep 17 00:00:00 2001
From: Ishpaul Singh <ishpaul207@gmail.com>
Date: Thu, 16 Apr 2026 01:02:43 +0530
Subject: [PATCH 08/16] Update rules document thumbnail styling and variable
 naming

- Change rulesDocumentThumbnailWidth to rulesDocumentThumbnailMaxWidth for clarity.
- Adjust thumbnail style to use maxWidth and set width to 100% for better responsiveness.
- Update PDFThumbnail component to use a flex style for improved layout.
---
 src/pages/workspace/WorkspaceOverviewPage.tsx | 7 +++++--
 src/styles/variables.ts                       | 2 +-
 2 files changed, 6 insertions(+), 3 deletions(-)

diff --git a/src/pages/workspace/WorkspaceOverviewPage.tsx b/src/pages/workspace/WorkspaceOverviewPage.tsx
index a096101b2b2a..8107db44da8d 100644
--- a/src/pages/workspace/WorkspaceOverviewPage.tsx
+++ b/src/pages/workspace/WorkspaceOverviewPage.tsx
@@ -204,7 +204,10 @@ function WorkspaceOverviewPage({policyDraft, policy: policyProp, route}: Workspa
         [policy?.rulesDocumentURL, policyID, session?.encryptedAuthToken],
     );
 
-    const rulesDocumentThumbnailStyle = useMemo(() => ({width: variables.rulesDocumentThumbnailWidth, height: variables.rulesDocumentThumbnailHeight}), []);
+    const rulesDocumentThumbnailStyle = useMemo(
+        () => ({width: '100%' as const, maxWidth: variables.rulesDocumentThumbnailMaxWidth, height: variables.rulesDocumentThumbnailHeight}),
+        [],
+    );
     const rulesDocumentMenuPositionStyle = useMemo(() => ({top: variables.spacing2, right: variables.spacing2}), []);
     const rulesDocumentMenuIconStyle = useMemo(() => ({borderRadius: variables.componentSizeNormal / 2, backgroundColor: theme.cardBG}), [theme.cardBG]);
 
@@ -835,7 +838,7 @@ function WorkspaceOverviewPage({policyDraft, policy: policyProp, route}: Workspa
                                                 >
                                                     <PDFThumbnail
                                                         previewSourceURL={rulesDocumentSourceURL}
-                                                        style={rulesDocumentThumbnailStyle}
+                                                        style={styles.flex1}
                                                     />
                                                 </PressableWithoutFeedback>
                                                 {isPolicyAdmin && (
diff --git a/src/styles/variables.ts b/src/styles/variables.ts
index 9619cf4ba961..fece2bcab300 100644
--- a/src/styles/variables.ts
+++ b/src/styles/variables.ts
@@ -22,7 +22,7 @@ export default {
     inputComponentSizeNormal: 40,
     componentSizeLarge: 52,
     spacing2: 8,
-    rulesDocumentThumbnailWidth: 368,
+    rulesDocumentThumbnailMaxWidth: 368,
     rulesDocumentThumbnailHeight: 200,
     componentBorderRadius: 8,
     componentBorderRadiusSmall: 4,

From d66d79bba7a55e951d1bdb00f96fc7b4c522a253 Mon Sep 17 00:00:00 2001
From: Ishpaul Singh <ishpaul207@gmail.com>
Date: Thu, 16 Apr 2026 01:06:24 +0530
Subject: [PATCH 09/16] Implement translation for policy document header in
 WorkspaceDocumentModalContent

---
 .../routes/WorkspaceDocumentModalContent.tsx                | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/src/pages/media/AttachmentModalScreen/routes/WorkspaceDocumentModalContent.tsx b/src/pages/media/AttachmentModalScreen/routes/WorkspaceDocumentModalContent.tsx
index 30e6d95ac1e7..05f96c7bc54e 100644
--- a/src/pages/media/AttachmentModalScreen/routes/WorkspaceDocumentModalContent.tsx
+++ b/src/pages/media/AttachmentModalScreen/routes/WorkspaceDocumentModalContent.tsx
@@ -1,4 +1,5 @@
 import React, {useMemo} from 'react';
+import useLocalize from '@hooks/useLocalize';
 import useOnyx from '@hooks/useOnyx';
 import usePolicy from '@hooks/usePolicy';
 import {getRulesDocumentSourceURL} from '@libs/PolicyUtils';
@@ -10,6 +11,7 @@ import type SCREENS from '@src/SCREENS';
 
 function WorkspaceDocumentModalContent({navigation, route}: AttachmentModalScreenProps<typeof SCREENS.WORKSPACE_DOCUMENT>) {
     const {policyID} = route.params;
+    const {translate} = useLocalize();
 
     const [session] = useOnyx(ONYXKEYS.SESSION);
     const policy = usePolicy(policyID);
@@ -29,13 +31,13 @@ function WorkspaceDocumentModalContent({navigation, route}: AttachmentModalScree
     const contentProps = useMemo<AttachmentModalBaseContentProps>(
         () => ({
             source: rulesDocumentSourceURL,
-            headerTitle: policy?.name ?? '',
+            headerTitle: translate('workspace.rules.customRules.policyDocument'),
             originalFileName: `${policyID}-policy-document.pdf`,
             shouldShowNotFoundPage,
             isLoading,
             shouldCloseOnSwipeDown: true,
         }),
-        [rulesDocumentSourceURL, policy?.name, policyID, shouldShowNotFoundPage, isLoading],
+        [rulesDocumentSourceURL, translate, policyID, shouldShowNotFoundPage, isLoading],
     );
 
     return (

From 4eb8454024e2d50014b48606b23814dea3ac1d64 Mon Sep 17 00:00:00 2001
From: Ishpaul Singh <ishpaul207@gmail.com>
Date: Thu, 16 Apr 2026 01:23:10 +0530
Subject: [PATCH 10/16] Enhance PDF document handling in policy updates

- Introduce file type validation to ensure only PDF documents are accepted for policy rules.
- Refactor document selection logic to improve readability and maintainability.
- Update UI to handle errors related to invalid file types more effectively.
---
 src/libs/actions/Policy/Policy.ts             | 10 ++++-
 src/pages/workspace/WorkspaceOverviewPage.tsx | 40 ++++++++++---------
 2 files changed, 31 insertions(+), 19 deletions(-)

diff --git a/src/libs/actions/Policy/Policy.ts b/src/libs/actions/Policy/Policy.ts
index afa14482cfd6..567c35cd01d5 100644
--- a/src/libs/actions/Policy/Policy.ts
+++ b/src/libs/actions/Policy/Policy.ts
@@ -82,7 +82,7 @@ import type {CustomRNImageManipulatorResult} from '@libs/cropOrRotateImage/types
 import * as CurrencyUtils from '@libs/CurrencyUtils';
 import DateUtils from '@libs/DateUtils';
 import * as ErrorUtils from '@libs/ErrorUtils';
-import {createFile} from '@libs/fileDownload/FileUtils';
+import {createFile, splitExtensionFromFileName} from '@libs/fileDownload/FileUtils';
 import getIsNarrowLayout from '@libs/getIsNarrowLayout';
 import GoogleTagManager from '@libs/GoogleTagManager';
 // eslint-disable-next-line @typescript-eslint/no-deprecated
@@ -1808,6 +1808,14 @@ function deleteWorkspaceAvatar(policyID: string, currentAvatarURL: string, curre
 }
 
 function updatePolicyRulesDocument(policyID: string, file: File, currentDocumentURL: string | undefined) {
+    const isPDF = file.type === 'application/pdf' || splitExtensionFromFileName(file.name ?? '').fileExtension.toLowerCase() === 'pdf';
+    if (!isPDF) {
+        Onyx.merge(`${ONYXKEYS.COLLECTION.POLICY}${policyID}`, {
+            errorFields: {rulesDocumentURL: ErrorUtils.getMicroSecondOnyxErrorWithTranslationKey('attachmentPicker.notAllowedExtension')},
+        });
+        return;
+    }
+
     const optimisticData: Array<OnyxUpdate<typeof ONYXKEYS.COLLECTION.POLICY>> = [
         {
             onyxMethod: Onyx.METHOD.MERGE,
diff --git a/src/pages/workspace/WorkspaceOverviewPage.tsx b/src/pages/workspace/WorkspaceOverviewPage.tsx
index 8107db44da8d..3d2484028bb6 100644
--- a/src/pages/workspace/WorkspaceOverviewPage.tsx
+++ b/src/pages/workspace/WorkspaceOverviewPage.tsx
@@ -204,10 +204,7 @@ function WorkspaceOverviewPage({policyDraft, policy: policyProp, route}: Workspa
         [policy?.rulesDocumentURL, policyID, session?.encryptedAuthToken],
     );
 
-    const rulesDocumentThumbnailStyle = useMemo(
-        () => ({width: '100%' as const, maxWidth: variables.rulesDocumentThumbnailMaxWidth, height: variables.rulesDocumentThumbnailHeight}),
-        [],
-    );
+    const rulesDocumentThumbnailStyle = useMemo(() => ({maxWidth: variables.rulesDocumentThumbnailMaxWidth, height: variables.rulesDocumentThumbnailHeight}), []);
     const rulesDocumentMenuPositionStyle = useMemo(() => ({top: variables.spacing2, right: variables.spacing2}), []);
     const rulesDocumentMenuIconStyle = useMemo(() => ({borderRadius: variables.componentSizeNormal / 2, backgroundColor: theme.cardBG}), [theme.cardBG]);
 
@@ -449,18 +446,21 @@ function WorkspaceOverviewPage({policyDraft, policy: policyProp, route}: Workspa
         return translate('common.leaveWorkspaceConfirmation');
     };
 
+    const handleRulesDocumentPicked = (files: FileObject[]) => {
+        const file = files.at(0);
+        if (!policyID || !file) {
+            return;
+        }
+        updatePolicyRulesDocument(policyID, file as File, policy?.rulesDocumentURL);
+    };
+
     const getRulesDocumentMenuItems = (openPicker: (options: {onPicked: (files: FileObject[]) => void}) => void): PopoverMenuItem[] => [
         {
             text: translate('common.replace'),
             icon: expensifyIcons.Upload,
             onSelected: () => {
                 openPicker({
-                    onPicked: (files: FileObject[]) => {
-                        if (!policyID || !files.length) {
-                            return;
-                        }
-                        updatePolicyRulesDocument(policyID, files.at(0) as File, policy?.rulesDocumentURL);
-                    },
+                    onPicked: handleRulesDocumentPicked,
                 });
             },
         },
@@ -817,13 +817,22 @@ function WorkspaceOverviewPage({policyDraft, policy: policyProp, route}: Workspa
                         subtitleTextStyles={[styles.textNormal, styles.colorMuted, styles.mr5]}
                         containerStyles={shouldUseNarrowLayout ? styles.p5 : styles.p8}
                     >
-                        <OfflineWithFeedback pendingAction={policy?.pendingFields?.rulesDocumentURL}>
+                        <OfflineWithFeedback
+                            pendingAction={policy?.pendingFields?.rulesDocumentURL}
+                            errors={getLatestErrorField(policy ?? {}, 'rulesDocumentURL')}
+                            onClose={() => {
+                                if (!policyID) {
+                                    return;
+                                }
+                                clearPolicyErrorField(policyID, 'rulesDocumentURL');
+                            }}
+                        >
                             <Text style={[styles.mutedTextLabel, styles.mb2]}>{translate('workspace.rules.customRules.policyDocument')}</Text>
                             <AttachmentPicker acceptedFileTypes={['pdf']}>
                                 {({openPicker}) => {
                                     if (policy?.rulesDocumentURL) {
                                         return (
-                                            <View style={rulesDocumentThumbnailStyle}>
+                                            <View style={[styles.w100, rulesDocumentThumbnailStyle]}>
                                                 <PressableWithoutFeedback
                                                     onPress={() => {
                                                         if (!policyID) {
@@ -865,12 +874,7 @@ function WorkspaceOverviewPage({policyDraft, policy: policyProp, route}: Workspa
                                                 text={translate('common.chooseFile')}
                                                 onPress={() => {
                                                     openPicker({
-                                                        onPicked: (files) => {
-                                                            if (!policyID || !files.length) {
-                                                                return;
-                                                            }
-                                                            updatePolicyRulesDocument(policyID, files.at(0) as File, policy?.rulesDocumentURL);
-                                                        },
+                                                        onPicked: handleRulesDocumentPicked,
                                                     });
                                                 }}
                                             />

From f3123534568577cc5a663f8e8256c183c64cf812 Mon Sep 17 00:00:00 2001
From: Ishpaul Singh <ishpaul207@gmail.com>
Date: Thu, 16 Apr 2026 01:57:40 +0530
Subject: [PATCH 11/16] Refactor custom rules section in WorkspaceOverviewPage

- Update conditional rendering for the custom rules section to improve clarity and maintainability.
- Adjust subtitle styles based on user permissions and document availability.
- Enhance document handling UI for better user experience, including improved layout and accessibility features.
---
 src/pages/workspace/WorkspaceOverviewPage.tsx | 154 +++++++++---------
 1 file changed, 79 insertions(+), 75 deletions(-)

diff --git a/src/pages/workspace/WorkspaceOverviewPage.tsx b/src/pages/workspace/WorkspaceOverviewPage.tsx
index 3d2484028bb6..fc23b60d076d 100644
--- a/src/pages/workspace/WorkspaceOverviewPage.tsx
+++ b/src/pages/workspace/WorkspaceOverviewPage.tsx
@@ -807,95 +807,99 @@ function WorkspaceOverviewPage({policyDraft, policy: policyProp, route}: Workspa
                         </OfflineWithFeedback>
                     )}
                 </Section>
-                {isBetaEnabled(CONST.BETAS.CUSTOM_RULES) ? (
+                {isBetaEnabled(CONST.BETAS.CUSTOM_RULES) && (isPolicyAdmin || !!policy?.rulesDocumentURL || !StringUtils.isEmptyString(policy?.customRules ?? '')) ? (
                     <Section
                         isCentralPane
                         title={translate('workspace.rules.customRules.title')}
                         titleStyles={[styles.textHeadline, styles.cardSectionTitle, styles.accountSettingsSectionTitle, styles.mb0]}
                         subtitle={translate('workspace.rules.customRules.cardSubtitle')}
-                        subtitleStyles={[styles.mb6]}
+                        subtitleStyles={[(isPolicyAdmin || !!policy?.rulesDocumentURL) ? styles.mb6 : styles.mb2]}
                         subtitleTextStyles={[styles.textNormal, styles.colorMuted, styles.mr5]}
                         containerStyles={shouldUseNarrowLayout ? styles.p5 : styles.p8}
                     >
-                        <OfflineWithFeedback
-                            pendingAction={policy?.pendingFields?.rulesDocumentURL}
-                            errors={getLatestErrorField(policy ?? {}, 'rulesDocumentURL')}
-                            onClose={() => {
-                                if (!policyID) {
-                                    return;
-                                }
-                                clearPolicyErrorField(policyID, 'rulesDocumentURL');
-                            }}
-                        >
-                            <Text style={[styles.mutedTextLabel, styles.mb2]}>{translate('workspace.rules.customRules.policyDocument')}</Text>
-                            <AttachmentPicker acceptedFileTypes={['pdf']}>
-                                {({openPicker}) => {
-                                    if (policy?.rulesDocumentURL) {
+                        {(isPolicyAdmin || !!policy?.rulesDocumentURL) && (
+                            <OfflineWithFeedback
+                                pendingAction={policy?.pendingFields?.rulesDocumentURL}
+                                errors={getLatestErrorField(policy ?? {}, 'rulesDocumentURL')}
+                                onClose={() => {
+                                    if (!policyID) {
+                                        return;
+                                    }
+                                    clearPolicyErrorField(policyID, 'rulesDocumentURL');
+                                }}
+                            >
+                                <Text style={[styles.mutedTextLabel, styles.mb2]}>{translate('workspace.rules.customRules.policyDocument')}</Text>
+                                <AttachmentPicker acceptedFileTypes={['pdf']}>
+                                    {({openPicker}) => {
+                                        if (policy?.rulesDocumentURL) {
+                                            return (
+                                                <View style={[styles.w100, rulesDocumentThumbnailStyle]}>
+                                                    <PressableWithoutFeedback
+                                                        onPress={() => {
+                                                            if (!policyID) {
+                                                                return;
+                                                            }
+                                                            Navigation.navigate(ROUTES.WORKSPACE_DOCUMENT.getRoute(policyID));
+                                                        }}
+                                                        role={CONST.ROLE.BUTTON}
+                                                        accessibilityLabel={translate('workspace.rules.customRules.policyDocument')}
+                                                        sentryLabel={CONST.SENTRY_LABEL.WORKSPACE.OVERVIEW.RULES_DOCUMENT}
+                                                        style={[styles.border, styles.borderRadiusComponentLarge, styles.overflowHidden, styles.flex1]}
+                                                    >
+                                                        <PDFThumbnail
+                                                            previewSourceURL={rulesDocumentSourceURL}
+                                                            style={styles.flex1}
+                                                        />
+                                                    </PressableWithoutFeedback>
+                                                    {isPolicyAdmin && (
+                                                        <View style={[styles.pAbsolute, rulesDocumentMenuPositionStyle]}>
+                                                            <ThreeDotsMenu
+                                                                menuItems={getRulesDocumentMenuItems(openPicker)}
+                                                                shouldSelfPosition
+                                                                iconStyles={[rulesDocumentMenuIconStyle]}
+                                                            />
+                                                        </View>
+                                                    )}
+                                                </View>
+                                            );
+                                        }
+
+                                        if (!isPolicyAdmin) {
+                                            return null;
+                                        }
+
                                         return (
-                                            <View style={[styles.w100, rulesDocumentThumbnailStyle]}>
-                                                <PressableWithoutFeedback
+                                            <View style={[styles.flexRow]}>
+                                                <Button
+                                                    medium
+                                                    text={translate('common.chooseFile')}
                                                     onPress={() => {
-                                                        if (!policyID) {
-                                                            return;
-                                                        }
-                                                        Navigation.navigate(ROUTES.WORKSPACE_DOCUMENT.getRoute(policyID));
+                                                        openPicker({
+                                                            onPicked: handleRulesDocumentPicked,
+                                                        });
                                                     }}
-                                                    role={CONST.ROLE.BUTTON}
-                                                    accessibilityLabel={translate('workspace.rules.customRules.policyDocument')}
-                                                    sentryLabel={CONST.SENTRY_LABEL.WORKSPACE.OVERVIEW.RULES_DOCUMENT}
-                                                    style={[styles.border, styles.borderRadiusComponentLarge, styles.overflowHidden, styles.flex1]}
-                                                >
-                                                    <PDFThumbnail
-                                                        previewSourceURL={rulesDocumentSourceURL}
-                                                        style={styles.flex1}
-                                                    />
-                                                </PressableWithoutFeedback>
-                                                {isPolicyAdmin && (
-                                                    <View style={[styles.pAbsolute, rulesDocumentMenuPositionStyle]}>
-                                                        <ThreeDotsMenu
-                                                            menuItems={getRulesDocumentMenuItems(openPicker)}
-                                                            shouldSelfPosition
-                                                            iconStyles={[rulesDocumentMenuIconStyle]}
-                                                        />
-                                                    </View>
-                                                )}
+                                                />
                                             </View>
                                         );
-                                    }
-
-                                    if (!isPolicyAdmin) {
-                                        return null;
-                                    }
-
-                                    return (
-                                        <View style={[styles.flexRow]}>
-                                            <Button
-                                                medium
-                                                text={translate('common.chooseFile')}
-                                                onPress={() => {
-                                                    openPicker({
-                                                        onPicked: handleRulesDocumentPicked,
-                                                    });
-                                                }}
-                                            />
-                                        </View>
-                                    );
-                                }}
-                            </AttachmentPicker>
-                        </OfflineWithFeedback>
+                                    }}
+                                </AttachmentPicker>
+                            </OfflineWithFeedback>
+                        )}
 
-                        <OfflineWithFeedback pendingAction={policy?.pendingFields?.customRules}>
-                            <MenuItemWithTopDescription
-                                title={policy?.customRules ?? ''}
-                                description={translate('workspace.rules.customRules.policyText')}
-                                sentryLabel={CONST.SENTRY_LABEL.WORKSPACE.OVERVIEW.CUSTOM_RULES}
-                                shouldShowRightIcon={!readOnly}
-                                interactive={!readOnly}
-                                wrapperStyle={[styles.sectionMenuItemTopDescription, styles.mt4]}
-                                onPress={() => Navigation.navigate(ROUTES.RULES_CUSTOM.getRoute(route.params.policyID))}
-                                shouldRenderAsHTML
-                            />
-                        </OfflineWithFeedback>
+                        {(isPolicyAdmin || !StringUtils.isEmptyString(policy?.customRules ?? '')) && (
+                            <OfflineWithFeedback pendingAction={policy?.pendingFields?.customRules}>
+                                <MenuItemWithTopDescription
+                                    title={policy?.customRules ?? ''}
+                                    description={translate('workspace.rules.customRules.policyText')}
+                                    sentryLabel={CONST.SENTRY_LABEL.WORKSPACE.OVERVIEW.CUSTOM_RULES}
+                                    shouldShowRightIcon={!readOnly}
+                                    interactive={!readOnly}
+                                    wrapperStyle={[styles.sectionMenuItemTopDescription, (isPolicyAdmin || !!policy?.rulesDocumentURL) && styles.mt4]}
+                                    onPress={() => Navigation.navigate(ROUTES.RULES_CUSTOM.getRoute(route.params.policyID))}
+                                    shouldRenderAsHTML
+                                />
+                            </OfflineWithFeedback>
+                        )}
                     </Section>
                 ) : null}
             </View>

From 8a12a4fdc996832339c2b4742eaefb0a94a049d7 Mon Sep 17 00:00:00 2001
From: Ishpaul Singh <ishpaul207@gmail.com>
Date: Thu, 16 Apr 2026 05:04:30 +0530
Subject: [PATCH 12/16] Fix prettier formatting in WorkspaceOverviewPage

---
 src/pages/workspace/WorkspaceOverviewPage.tsx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/pages/workspace/WorkspaceOverviewPage.tsx b/src/pages/workspace/WorkspaceOverviewPage.tsx
index fc23b60d076d..6182e6dc592b 100644
--- a/src/pages/workspace/WorkspaceOverviewPage.tsx
+++ b/src/pages/workspace/WorkspaceOverviewPage.tsx
@@ -813,7 +813,7 @@ function WorkspaceOverviewPage({policyDraft, policy: policyProp, route}: Workspa
                         title={translate('workspace.rules.customRules.title')}
                         titleStyles={[styles.textHeadline, styles.cardSectionTitle, styles.accountSettingsSectionTitle, styles.mb0]}
                         subtitle={translate('workspace.rules.customRules.cardSubtitle')}
-                        subtitleStyles={[(isPolicyAdmin || !!policy?.rulesDocumentURL) ? styles.mb6 : styles.mb2]}
+                        subtitleStyles={[isPolicyAdmin || !!policy?.rulesDocumentURL ? styles.mb6 : styles.mb2]}
                         subtitleTextStyles={[styles.textNormal, styles.colorMuted, styles.mr5]}
                         containerStyles={shouldUseNarrowLayout ? styles.p5 : styles.p8}
                     >

From f2553e6d2ba8b06ac00a4c31675d1e33e5d8ea62 Mon Sep 17 00:00:00 2001
From: Ishpaul Singh <ishpaul207@gmail.com>
Date: Thu, 16 Apr 2026 17:47:05 +0530
Subject: [PATCH 13/16] Wire download action into workspace document modal

---
 .../routes/WorkspaceDocumentModalContent.tsx                | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/src/pages/media/AttachmentModalScreen/routes/WorkspaceDocumentModalContent.tsx b/src/pages/media/AttachmentModalScreen/routes/WorkspaceDocumentModalContent.tsx
index 05f96c7bc54e..b1e538119571 100644
--- a/src/pages/media/AttachmentModalScreen/routes/WorkspaceDocumentModalContent.tsx
+++ b/src/pages/media/AttachmentModalScreen/routes/WorkspaceDocumentModalContent.tsx
@@ -8,6 +8,7 @@ import AttachmentModalContainer from '@pages/media/AttachmentModalScreen/Attachm
 import type {AttachmentModalScreenProps} from '@pages/media/AttachmentModalScreen/types';
 import ONYXKEYS from '@src/ONYXKEYS';
 import type SCREENS from '@src/SCREENS';
+import useDownloadAttachment from './hooks/useDownloadAttachment';
 
 function WorkspaceDocumentModalContent({navigation, route}: AttachmentModalScreenProps<typeof SCREENS.WORKSPACE_DOCUMENT>) {
     const {policyID} = route.params;
@@ -28,6 +29,8 @@ function WorkspaceDocumentModalContent({navigation, route}: AttachmentModalScree
         [policy?.rulesDocumentURL, policyID, session?.encryptedAuthToken],
     );
 
+    const onDownloadAttachment = useDownloadAttachment();
+
     const contentProps = useMemo<AttachmentModalBaseContentProps>(
         () => ({
             source: rulesDocumentSourceURL,
@@ -35,9 +38,10 @@ function WorkspaceDocumentModalContent({navigation, route}: AttachmentModalScree
             originalFileName: `${policyID}-policy-document.pdf`,
             shouldShowNotFoundPage,
             isLoading,
+            onDownloadAttachment,
             shouldCloseOnSwipeDown: true,
         }),
-        [rulesDocumentSourceURL, translate, policyID, shouldShowNotFoundPage, isLoading],
+        [rulesDocumentSourceURL, translate, policyID, shouldShowNotFoundPage, isLoading, onDownloadAttachment],
     );
 
     return (

From 00b1593810866df6323a6a8bf31a8f4dad331781 Mon Sep 17 00:00:00 2001
From: Ishpaul Singh <ishpaul207@gmail.com>
Date: Thu, 16 Apr 2026 22:22:02 +0530
Subject: [PATCH 14/16] Extract named booleans for readability, remove
 eslint-disable

---
 .../routes/WorkspaceDocumentModalContent.tsx      |  7 +++----
 src/pages/workspace/WorkspaceOverviewPage.tsx     | 15 ++++++++++-----
 2 files changed, 13 insertions(+), 9 deletions(-)

diff --git a/src/pages/media/AttachmentModalScreen/routes/WorkspaceDocumentModalContent.tsx b/src/pages/media/AttachmentModalScreen/routes/WorkspaceDocumentModalContent.tsx
index b1e538119571..74bfa2e8feb3 100644
--- a/src/pages/media/AttachmentModalScreen/routes/WorkspaceDocumentModalContent.tsx
+++ b/src/pages/media/AttachmentModalScreen/routes/WorkspaceDocumentModalContent.tsx
@@ -20,8 +20,7 @@ function WorkspaceDocumentModalContent({navigation, route}: AttachmentModalScree
 
     const policyKeysLength = Object.keys(policy ?? {}).length;
 
-    // eslint-disable-next-line rulesdir/no-negated-variables
-    const shouldShowNotFoundPage = (policyKeysLength === 0 && !isLoadingApp) || !policy?.rulesDocumentURL;
+    const isDocumentAvailable = (policyKeysLength > 0 || !!isLoadingApp) && !!policy?.rulesDocumentURL;
     const isLoading = policyKeysLength === 0 && !!isLoadingApp;
 
     const rulesDocumentSourceURL = useMemo(
@@ -36,12 +35,12 @@ function WorkspaceDocumentModalContent({navigation, route}: AttachmentModalScree
             source: rulesDocumentSourceURL,
             headerTitle: translate('workspace.rules.customRules.policyDocument'),
             originalFileName: `${policyID}-policy-document.pdf`,
-            shouldShowNotFoundPage,
+            shouldShowNotFoundPage: !isDocumentAvailable,
             isLoading,
             onDownloadAttachment,
             shouldCloseOnSwipeDown: true,
         }),
-        [rulesDocumentSourceURL, translate, policyID, shouldShowNotFoundPage, isLoading, onDownloadAttachment],
+        [rulesDocumentSourceURL, translate, policyID, isDocumentAvailable, isLoading, onDownloadAttachment],
     );
 
     return (
diff --git a/src/pages/workspace/WorkspaceOverviewPage.tsx b/src/pages/workspace/WorkspaceOverviewPage.tsx
index 6182e6dc592b..503b083c751f 100644
--- a/src/pages/workspace/WorkspaceOverviewPage.tsx
+++ b/src/pages/workspace/WorkspaceOverviewPage.tsx
@@ -204,6 +204,11 @@ function WorkspaceOverviewPage({policyDraft, policy: policyProp, route}: Workspa
         [policy?.rulesDocumentURL, policyID, session?.encryptedAuthToken],
     );
 
+    const hasRulesDocument = !!policy?.rulesDocumentURL;
+    const hasCustomRulesText = !StringUtils.isEmptyString(policy?.customRules ?? '');
+    const shouldShowExpensePolicySection = isBetaEnabled(CONST.BETAS.CUSTOM_RULES) && (isPolicyAdmin || hasRulesDocument || hasCustomRulesText);
+    const shouldShowRulesDocumentSubSection = isPolicyAdmin || hasRulesDocument;
+
     const rulesDocumentThumbnailStyle = useMemo(() => ({maxWidth: variables.rulesDocumentThumbnailMaxWidth, height: variables.rulesDocumentThumbnailHeight}), []);
     const rulesDocumentMenuPositionStyle = useMemo(() => ({top: variables.spacing2, right: variables.spacing2}), []);
     const rulesDocumentMenuIconStyle = useMemo(() => ({borderRadius: variables.componentSizeNormal / 2, backgroundColor: theme.cardBG}), [theme.cardBG]);
@@ -807,17 +812,17 @@ function WorkspaceOverviewPage({policyDraft, policy: policyProp, route}: Workspa
                         </OfflineWithFeedback>
                     )}
                 </Section>
-                {isBetaEnabled(CONST.BETAS.CUSTOM_RULES) && (isPolicyAdmin || !!policy?.rulesDocumentURL || !StringUtils.isEmptyString(policy?.customRules ?? '')) ? (
+                {shouldShowExpensePolicySection ? (
                     <Section
                         isCentralPane
                         title={translate('workspace.rules.customRules.title')}
                         titleStyles={[styles.textHeadline, styles.cardSectionTitle, styles.accountSettingsSectionTitle, styles.mb0]}
                         subtitle={translate('workspace.rules.customRules.cardSubtitle')}
-                        subtitleStyles={[isPolicyAdmin || !!policy?.rulesDocumentURL ? styles.mb6 : styles.mb2]}
+                        subtitleStyles={[shouldShowRulesDocumentSubSection ? styles.mb6 : styles.mb2]}
                         subtitleTextStyles={[styles.textNormal, styles.colorMuted, styles.mr5]}
                         containerStyles={shouldUseNarrowLayout ? styles.p5 : styles.p8}
                     >
-                        {(isPolicyAdmin || !!policy?.rulesDocumentURL) && (
+                        {shouldShowRulesDocumentSubSection && (
                             <OfflineWithFeedback
                                 pendingAction={policy?.pendingFields?.rulesDocumentURL}
                                 errors={getLatestErrorField(policy ?? {}, 'rulesDocumentURL')}
@@ -886,7 +891,7 @@ function WorkspaceOverviewPage({policyDraft, policy: policyProp, route}: Workspa
                             </OfflineWithFeedback>
                         )}
 
-                        {(isPolicyAdmin || !StringUtils.isEmptyString(policy?.customRules ?? '')) && (
+                        {(isPolicyAdmin || hasCustomRulesText) && (
                             <OfflineWithFeedback pendingAction={policy?.pendingFields?.customRules}>
                                 <MenuItemWithTopDescription
                                     title={policy?.customRules ?? ''}
@@ -894,7 +899,7 @@ function WorkspaceOverviewPage({policyDraft, policy: policyProp, route}: Workspa
                                     sentryLabel={CONST.SENTRY_LABEL.WORKSPACE.OVERVIEW.CUSTOM_RULES}
                                     shouldShowRightIcon={!readOnly}
                                     interactive={!readOnly}
-                                    wrapperStyle={[styles.sectionMenuItemTopDescription, (isPolicyAdmin || !!policy?.rulesDocumentURL) && styles.mt4]}
+                                    wrapperStyle={[styles.sectionMenuItemTopDescription, shouldShowRulesDocumentSubSection && styles.mt4]}
                                     onPress={() => Navigation.navigate(ROUTES.RULES_CUSTOM.getRoute(route.params.policyID))}
                                     shouldRenderAsHTML
                                 />

From 77e8490782f41bae1acfffa3869be52b14ef7de9 Mon Sep 17 00:00:00 2001
From: Ishpaul Singh <ishpaul207@gmail.com>
Date: Wed, 22 Apr 2026 21:16:46 +0530
Subject: [PATCH 15/16] Fix download button, three-dots styling, and iOS
 replace on workspace document

- Show download button in workspace document modal by including onDownloadAttachment in isValidContext check
- Use receiptActionButton style for three-dots menu to match receipt preview icon buttons
- Add shouldCallAfterModalHide to Replace menu item so native picker opens after popover closes
---
 .../AttachmentModalBaseContent/index.tsx                    | 2 +-
 src/pages/workspace/WorkspaceOverviewPage.tsx               | 6 ++----
 2 files changed, 3 insertions(+), 5 deletions(-)

diff --git a/src/pages/media/AttachmentModalScreen/AttachmentModalBaseContent/index.tsx b/src/pages/media/AttachmentModalScreen/AttachmentModalBaseContent/index.tsx
index 44a79444b5d1..5ae30502c965 100644
--- a/src/pages/media/AttachmentModalScreen/AttachmentModalBaseContent/index.tsx
+++ b/src/pages/media/AttachmentModalScreen/AttachmentModalBaseContent/index.tsx
@@ -188,7 +188,7 @@ function AttachmentModalBaseContent({
     const {isAttachmentLoaded} = useContext(AttachmentStateContext);
     const isEReceipt = transaction && !hasReceiptSource(transaction) && hasEReceipt(transaction);
     const shouldShowDownloadButton = useMemo(() => {
-        const isValidContext = !isEmptyObject(report) || type === CONST.ATTACHMENT_TYPE.SEARCH;
+        const isValidContext = !isEmptyObject(report) || type === CONST.ATTACHMENT_TYPE.SEARCH || !!onDownloadAttachment;
         if (!isValidContext || isErrorInAttachment(source) || isEReceipt) {
             return false;
         }
diff --git a/src/pages/workspace/WorkspaceOverviewPage.tsx b/src/pages/workspace/WorkspaceOverviewPage.tsx
index 503b083c751f..e217299b3fdc 100644
--- a/src/pages/workspace/WorkspaceOverviewPage.tsx
+++ b/src/pages/workspace/WorkspaceOverviewPage.tsx
@@ -35,7 +35,6 @@ import usePrevious from '@hooks/usePrevious';
 import usePrivateSubscription from '@hooks/usePrivateSubscription';
 import useResponsiveLayout from '@hooks/useResponsiveLayout';
 import useShouldBlockCurrencyChange from '@hooks/useShouldBlockCurrencyChange';
-import useTheme from '@hooks/useTheme';
 import useThemeStyles from '@hooks/useThemeStyles';
 import useTransactionViolationOfWorkspace from '@hooks/useTransactionViolationOfWorkspace';
 import useWorkspaceDocumentTitle from '@hooks/useWorkspaceDocumentTitle';
@@ -95,7 +94,6 @@ import WorkspacePageWithSections from './WorkspacePageWithSections';
 type WorkspaceOverviewPageProps = WithPolicyProps & PlatformStackScreenProps<WorkspaceSplitNavigatorParamList, typeof SCREENS.WORKSPACE.PROFILE>;
 
 function WorkspaceOverviewPage({policyDraft, policy: policyProp, route}: WorkspaceOverviewPageProps) {
-    const theme = useTheme();
     const styles = useThemeStyles();
     const {translate, localeCompare} = useLocalize();
     const {shouldUseNarrowLayout} = useResponsiveLayout();
@@ -211,7 +209,6 @@ function WorkspaceOverviewPage({policyDraft, policy: policyProp, route}: Workspa
 
     const rulesDocumentThumbnailStyle = useMemo(() => ({maxWidth: variables.rulesDocumentThumbnailMaxWidth, height: variables.rulesDocumentThumbnailHeight}), []);
     const rulesDocumentMenuPositionStyle = useMemo(() => ({top: variables.spacing2, right: variables.spacing2}), []);
-    const rulesDocumentMenuIconStyle = useMemo(() => ({borderRadius: variables.componentSizeNormal / 2, backgroundColor: theme.cardBG}), [theme.cardBG]);
 
     const personalDetails = usePersonalDetails();
     const [accountIDToLogin] = useOnyx(ONYXKEYS.PERSONAL_DETAILS_LIST, {selector: accountIDToLoginSelector(reportsToArchive)});
@@ -463,6 +460,7 @@ function WorkspaceOverviewPage({policyDraft, policy: policyProp, route}: Workspa
         {
             text: translate('common.replace'),
             icon: expensifyIcons.Upload,
+            shouldCallAfterModalHide: true,
             onSelected: () => {
                 openPicker({
                     onPicked: handleRulesDocumentPicked,
@@ -861,7 +859,7 @@ function WorkspaceOverviewPage({policyDraft, policy: policyProp, route}: Workspa
                                                             <ThreeDotsMenu
                                                                 menuItems={getRulesDocumentMenuItems(openPicker)}
                                                                 shouldSelfPosition
-                                                                iconStyles={[rulesDocumentMenuIconStyle]}
+                                                                iconStyles={[styles.receiptActionButton]}
                                                             />
                                                         </View>
                                                     )}

From e6450faf5495bbddf5da13981b81f93863ee66bf Mon Sep 17 00:00:00 2001
From: Ishpaul Singh <ishpaul207@gmail.com>
Date: Wed, 22 Apr 2026 21:39:52 +0530
Subject: [PATCH 16/16] Forward acceptedFileTypes to native picker, skip
 attachment type modal

- Map acceptedFileTypes extensions to native picker types (UTIs on iOS, MIME on Android)
- Add shouldSkipAttachmentTypeModal prop to bypass Camera/Gallery/Document modal
- Use shouldSkipAttachmentTypeModal for workspace rules document picker
- Remove all type assertions in favor of String() coercion
---
 .../AttachmentPicker/index.native.tsx         | 79 +++++++++++++++----
 src/components/AttachmentPicker/types.ts      |  3 +
 src/pages/workspace/WorkspaceOverviewPage.tsx |  5 +-
 3 files changed, 71 insertions(+), 16 deletions(-)

diff --git a/src/components/AttachmentPicker/index.native.tsx b/src/components/AttachmentPicker/index.native.tsx
index 61f9f0d5270a..072814182b75 100644
--- a/src/components/AttachmentPicker/index.native.tsx
+++ b/src/components/AttachmentPicker/index.native.tsx
@@ -27,6 +27,25 @@ import type IconAsset from '@src/types/utils/IconAsset';
 import launchCamera from './launchCamera/launchCamera';
 import type AttachmentPickerProps from './types';
 
+const EXTENSION_TO_NATIVE_TYPE: Record<string, string> = {
+    pdf: String(types.pdf),
+    doc: String(types.doc),
+    msword: String(types.doc),
+    zip: String(types.zip),
+    text: String(types.plainText),
+    json: String(types.json),
+    xls: String(types.xls),
+    xlsx: String(types.xlsx),
+    jpg: String(types.images),
+    jpeg: String(types.images),
+    png: String(types.images),
+    gif: String(types.images),
+    heif: String(types.images),
+    heic: String(types.images),
+    tif: String(types.images),
+    tiff: String(types.images),
+};
+
 type LocalCopy = {
     name: string | null;
     uri: string;
@@ -121,8 +140,10 @@ function AttachmentPicker({
     shouldHideCameraOption = false,
     shouldValidateImage = true,
     shouldHideGalleryOption = false,
+    acceptedFileTypes,
     fileLimit = 1,
     onOpenPicker,
+    shouldSkipAttachmentTypeModal = false,
 }: AttachmentPickerProps) {
     const icons = useMemoizedLazyExpensifyIcons(['Camera', 'Gallery', 'Paperclip']);
     const styles = useThemeStyles();
@@ -251,8 +272,22 @@ function AttachmentPicker({
      * Launch the DocumentPicker. Results are in the same format as ImagePicker
      */
     const showDocumentPicker = useCallback(async (): Promise<LocalCopy[]> => {
+        let pickerTypes: string[];
+        if (acceptedFileTypes && acceptedFileTypes.length > 0) {
+            const mappedTypes = acceptedFileTypes.reduce<string[]>((result, extension) => {
+                const nativeType = EXTENSION_TO_NATIVE_TYPE[String(extension)];
+                if (nativeType !== undefined && !result.includes(nativeType)) {
+                    result.push(nativeType);
+                }
+                return result;
+            }, []);
+            pickerTypes = mappedTypes.length > 0 ? mappedTypes : [types.allFiles];
+        } else {
+            pickerTypes = [type === CONST.ATTACHMENT_PICKER_TYPE.IMAGE ? types.images : types.allFiles];
+        }
+
         const pickedFiles = await pick({
-            type: [type === CONST.ATTACHMENT_PICKER_TYPE.IMAGE ? types.images : types.allFiles],
+            type: pickerTypes,
             allowMultiSelection: fileLimit !== 1,
         });
 
@@ -280,7 +315,7 @@ function AttachmentPicker({
                 type: file.type,
             };
         });
-    }, [fileLimit, type]);
+    }, [acceptedFileTypes, fileLimit, type]);
 
     const menuItemData: Item[] = useMemo(() => {
         const data: Item[] = [
@@ -336,19 +371,6 @@ function AttachmentPicker({
         [showGeneralAlert, showImageCorruptionAlert, translate],
     );
 
-    /**
-     * Opens the attachment modal
-     *
-     * @param onPickedHandler A callback that will be called with the selected attachment
-     * @param onCanceledHandler A callback that will be called without a selected attachment
-     */
-    const open = (onPickedHandler: (files: FileObject[]) => void, onCanceledHandler: () => void = () => {}, onClosedHandler: () => void = () => {}) => {
-        completeAttachmentSelection.current = onPickedHandler;
-        onCanceled.current = onCanceledHandler;
-        onClosed.current = onClosedHandler;
-        setIsVisible(true);
-    };
-
     /**
      * Closes the attachment modal
      */
@@ -442,6 +464,33 @@ function AttachmentPicker({
         [handleImageProcessingError, shouldValidateImage, showGeneralAlert, showImageCorruptionAlert],
     );
 
+    /**
+     * Opens the attachment modal, or directly launches the document picker when shouldSkipAttachmentTypeModal is true.
+     */
+    const open = (onPickedHandler: (files: FileObject[]) => void, onCanceledHandler: () => void = () => {}, onClosedHandler: () => void = () => {}) => {
+        completeAttachmentSelection.current = onPickedHandler;
+        onCanceled.current = onCanceledHandler;
+        onClosed.current = onClosedHandler;
+
+        if (shouldSkipAttachmentTypeModal) {
+            onOpenPicker?.();
+            showDocumentPicker()
+                .catch((error: Error) => {
+                    if (JSON.stringify(error).includes('OPERATION_CANCELED')) {
+                        return;
+                    }
+                    showGeneralAlert(error.message);
+                    throw error;
+                })
+                .then((result) => pickAttachment(result))
+                .catch(console.error)
+                .finally(() => onClosedHandler());
+            return;
+        }
+
+        setIsVisible(true);
+    };
+
     /**
      * Setup native attachment selection to start after this popover closes
      *
diff --git a/src/components/AttachmentPicker/types.ts b/src/components/AttachmentPicker/types.ts
index 362eb6759fb3..03ec003c9d66 100644
--- a/src/components/AttachmentPicker/types.ts
+++ b/src/components/AttachmentPicker/types.ts
@@ -60,6 +60,9 @@ type AttachmentPickerProps = {
 
     /** A callback that will be called when the picker is opened. */
     onOpenPicker?: () => void;
+
+    /** When true, skip the Camera/Gallery/Document modal and open the document picker directly (native only). */
+    shouldSkipAttachmentTypeModal?: boolean;
 };
 
 export default AttachmentPickerProps;
diff --git a/src/pages/workspace/WorkspaceOverviewPage.tsx b/src/pages/workspace/WorkspaceOverviewPage.tsx
index e217299b3fdc..ca908d0506b0 100644
--- a/src/pages/workspace/WorkspaceOverviewPage.tsx
+++ b/src/pages/workspace/WorkspaceOverviewPage.tsx
@@ -832,7 +832,10 @@ function WorkspaceOverviewPage({policyDraft, policy: policyProp, route}: Workspa
                                 }}
                             >
                                 <Text style={[styles.mutedTextLabel, styles.mb2]}>{translate('workspace.rules.customRules.policyDocument')}</Text>
-                                <AttachmentPicker acceptedFileTypes={['pdf']}>
+                                <AttachmentPicker
+                                    acceptedFileTypes={['pdf']}
+                                    shouldSkipAttachmentTypeModal
+                                >
                                     {({openPicker}) => {
                                         if (policy?.rulesDocumentURL) {
                                             return (