Custodia Feature Reference Guide – Custodia

This guide describes every configurable feature flag in the Custodia platform. Features control what functionality is available to a given tenant. Each feature has a code (the system identifier), and a minimum license tier that determines whether it is automatically available or must be explicitly granted.

License Tiers (lowest to highest)

benefit-card — Base tier for benefit-card programs. Features at this tier are available to all tenants.
light — Lightweight spend management. Adds basic card issuance and receipt features.
startup — Full spend management for smaller companies. Adds company-level expenses, mobile app requests, and more.
enterprise — Advanced features for larger organizations. Adds analytics, policies, expense splitting, reimbursements, and more.
unlimited — Must be explicitly granted by Custodia support or the card issuer. Used for integrations, automations, and advanced operational features.
support — Internal Custodia support operations only. Not available to tenants.

A tenant at a given tier automatically has access to all features at that tier and below. Features marked unlimited are never auto-granted — they must be turned on individually per tenant.

Accounting Integrations

These features enable bi-directional synchronization of expense data between Custodia and external accounting/ERP systems. When enabled, tenants can configure their accounting integration from the Company Admin area and push approved expenses to their accounting system.

Microsoft Dynamics Integration (Accounting/Dynamics, unlimited) — Syncs expense data with Microsoft Dynamics 365. Requires Dynamics credentials to be configured in Company Admin.
NetSuite Integration (Accounting/NetSuite, unlimited) — Syncs expense data with Oracle NetSuite. Supports mapping GL accounts, cost centers, and subsidiaries to NetSuite dimensions.
Priority Integration (Accounting/Priority, unlimited) — Syncs expense data with Priority ERP. Commonly used by tenants in Israel.
QuickBooks Integration (Accounting/QuickBooks, startup) — Syncs expense data with Intuit QuickBooks. The only accounting integration available below the unlimited tier.

Activity / Spend Permissions

Activities are the core spend-control mechanism in Custodia. Each activity represents a permission for an employee to spend within defined parameters: a budget, a timeframe, merchant restrictions, and transaction rules. This is the largest feature category.

Core & Viewing

View Activities (Activities, benefit-card) — The foundational feature that enables the activities list page. Without this, users cannot see any activities. Virtually every tenant has this enabled.
Activity Change History (Activity/ChangeHistory, benefit-card) — Shows an audit trail of every change made to an activity: budget adjustments, date changes, lock/unlock, and who made the change.
Activity Advanced Settings (Activity/AdvancedSettings, benefit-card) — Exposes additional configuration options when creating or editing activities, such as merchant restrictions, card-present mode, and daily limits.
Activity Type MCC Info (Activity/MccInfo, unlimited) — Displays Merchant Category Code (MCC) information within activity type configurations, helping admins understand which merchant categories an activity type targets.

Creation & Requests

Create Spend Permissions (Activity/CreatePermission, benefit-card) — Allows managers to create spend permission activities on behalf of employees. This is the primary way managers allocate spend to their teams.
Create Spend Permission from Mobile App (Activity/CreatePermission/App, unlimited) — Extends the above to the mobile app, so managers can grant spend permissions on the go.
Create Spend Requests (Activity/CreateRequest, benefit-card) — Allows employees to request spend permissions for themselves. Requests go through the approval workflow before becoming active.
Create Spend Request from Mobile App (Activity/CreateRequest/App, startup) — Allows employees to submit spend requests from the mobile app.
Bulk Activity Creation (Activity/BulkCreation, benefit-card) — Create multiple activities at once for multiple employees in a single operation.
Bulk Activities In Progress (Activity/BulkInProgress, benefit-card) — Enables tracking of bulk activity creation operations that are still being processed in the background.
Import Activities via CSV/Excel (Activity/UploadCSV, benefit-card) — Allows bulk creation of activities by uploading a CSV or Excel file with activity definitions.
Search Activity Templates (Activity/TemplateSearch, benefit-card) — Adds a search box when selecting activity templates during creation, useful when there are many templates.
Start Activity from Budget (Activity/StartWithBudget, unlimited) — Allows creating a new activity directly from an existing budget allocation, pre-filling the budget details.
Single-Use Ad-Hoc Activity (SingleUseActivity, unlimited) — Enables one-time ad-hoc spend requests, typically created after a transaction is declined so the employee can retry immediately.

Editing

Edit Activity Metadata (Activity/Edit, benefit-card) — Allows editing activity details like name, description, tags, and dates after creation.
Edit Activity Type (Activity/Edit/Type, enterprise) — Allows changing the template/type of an existing activity after it was created.
Edit Budget Allocation Expense Type (Activity/Edit/BAExpenseType, enterprise) — Allows changing the expense type assigned to a budget allocation after the activity is created.
Edit Group-Linked Activities (Activity/Edit/LinkedToGroup, startup) — Allows editing activities that are linked to a group activity, which is normally restricted.
Edit Non-Editable Activities (Activity/EditNonEditable, benefit-card) — Overrides the non-editable flag, allowing administrators to edit activities that would otherwise be locked from changes.
Skip Workflow for Date/Budget Changes (Activity/Edit/DatesAndBudget/SkipWorkflow, benefit-card) — Bypasses the approval workflow when a manager edits activity dates or budget amounts, allowing instant changes.
Update Expired Activities (Activity/UpdateExpired, benefit-card) — Allows editing activities that have already passed their end date.
Update Shared Activity (Activity/UpdateSharedActivity, unlimited) — Allows updating activities that are shared between multiple users.
Mass Update Activities (Activity/MassUpdate, unlimited) — Enables bulk-updating multiple activities at once from the web interface (e.g., extending dates or changing budgets for many activities).

Budget & Financial Controls

Activity Balance Update (Activity/BalanceUpdate, unlimited) — Enables manual adjustment of an activity's remaining balance for budget corrections.
Change Activity Budget Line (Activity/ChangeBudget, enterprise) — Allows reassigning an activity to a different budget line item.
Change Activity to Any Budget (Activity/ChangeBudget/anyBudget, unlimited) — Extends the above to allow selecting any budget in the system, not just budgets within the user's scope.
Budget Selection in Mobile App (Activity/ChangeBudget/App, unlimited) — Allows budget selection when creating activities from the mobile app.
Change Activity Currency (Activity/ChangeCurrency, light) — Allows changing the currency of an activity after creation.
Change GL Account (Activity/ChangeGlAccount, enterprise) — Allows changing the General Ledger account code assigned to an activity.
Multi-Currency Activity (Activity/MultiCurrency, startup) — Allows a single activity to accept transactions in multiple currencies, with conversion handled automatically.
Split Activity Budget (Activity/SplitBudget, benefit-card) — Allows sharing/splitting an activity's budget allocation with a different employee.
Merge Activity Budgets (Activity/MergeBudget, enterprise) — Allows merging the remaining budget from one activity into another.
Import Credit to Activity (Activity/ImportCredit, unlimited) — Enables importing credit transactions (refunds, returns) into an activity's transaction history.
Force Cost Center Selection (Activity/ForceCostCenter, benefit-card) — Allows selecting a cost center not normally assigned to the user when creating an activity.
Activity Out-of-Pocket Settings (Activity/OutOfPocket, unlimited) — Enables editing out-of-pocket reimbursement settings on individual activities.

Restrictions & Controls

Force Country Restrictions (Activity/ActiveForCountryCodes, enterprise) — Restricts an activity to only accept transactions from specific countries, enabling geo-based spend controls.
Force Currency Restrictions (Activity/ActiveForCurrencies, benefit-card) — Restricts an activity to only accept transactions in specific currencies.
Bind Activity to Card (Activity/BoundToCard, benefit-card) — Binds an activity to a specific card so that only that card can spend against it.
Card Present Transaction Mode (Activity/CardPresent, unlimited) — Restricts spend to in-person POS (card-present) transactions only, blocking online purchases.
ATM Withdrawal from Activity Budget (Activity/ATM, benefit-card) — Allows using ATM cash withdrawals against an activity's budget.
Hide Activity Limits from Owner (Activity/HideLimits, startup) — Hides the budget limit amounts from the employee who owns the activity. Useful for benefit-card scenarios where the company doesn't want employees to see their allowance ceiling.
Override Hidden Limits (Activity/HideLimits/Skip, benefit-card) — Overrides the above for specific roles (e.g., managers), allowing them to see limits even when hidden from regular employees.
Require Receipt on Activity (Activity/RequireReceipt, unlimited) — Enforces receipt attachment requirements at the activity level for all transactions against it.
Force My Team Search (Activity/Manager/ForceMyTeamSearch, unlimited) — Forces the activity search view to default to the manager's own team scope rather than showing all activities.

Locks & Lifecycle

Lock All Activities (Activity/LockAll, benefit-card) — Enables a bulk action to lock all activities for a tenant at once, preventing any further spend.
Lock Activity by Administrator (Activity/LockByAdmin, benefit-card) — Allows administrators to manually lock individual activities.
Lock Activities by Default (Activity/LockedByDefault, benefit-card) — New activities are created in a locked state by default and must be explicitly unlocked before spend is allowed.
Auto-Extend Activity (Activity/AutoExtend, enterprise) — Automatically extends an activity's end date when it is about to expire, keeping the spend permission active.
Auto-Lock on Buffer Usage (Activity/AutoLockOnBufferUsage, unlimited) — Automatically locks an activity when its buffer/margin allocation has been fully consumed.

Recurring & Scheduled

Recurring Activity Creation (Activity/Recurring, benefit-card) — Allows creating activities that automatically recur on a schedule (e.g., monthly meal allowance). The system creates a new activity each period with the same parameters.
Bi-Weekly Recurring Activity (Activity/Recurring/BiWeekly, unlimited) — Adds bi-weekly as an additional recurrence frequency option beyond the standard monthly/weekly.
Activity Recurring Payment (Activity/RecurringPayment, unlimited) — Enables recurring payment mode on activities for subscription-style payments. Unlike recurring activities (which create new activities each period), this allows a single activity to authorize repeated charges.

Attachments, Export & Other

Add Attachments to Activity Requests (Activity/AddAttachments, unlimited) — Allows users to attach files (quotes, invoices, etc.) when creating or editing activity requests.
Add Attachments During Activity Creation (Activity/Creation/AddAttachments, unlimited) — Specifically enables the attachment upload UI during the activity creation flow.
Export Activities as CSV (Activity/ExportAsCsv, benefit-card) — Adds a button to export the activities list to a CSV file for offline analysis.
Group Pay (Activity/GroupPay, benefit-card) — Enables group pay activities where a single activity covers spend for multiple users (e.g., a team dinner).
3rd Party Activity Integration (Activity/3rdParty, unlimited) — Enables integration with external third-party systems that can create and manage activities via API.
Cibus Integration (Activity/3rdParty/Cibus, unlimited) — Specific integration with the Cibus meal benefits platform for activity management.

Analytics & Reporting

Analytics features provide spend insights, visualizations, and reporting tools. The platform supports both pre-built reports and free-form data exploration.

Canned Reports (Analytics/Basic, unlimited) — Pre-built analytics reports with standard spend insights such as spend by department, by category, and by period.
Budget Utilization Analytics (Analytics/Budget, enterprise) — Budget utilization reports showing consumption rates, remaining balances, and trends over time. Helps finance teams identify under- and over-utilized budgets.
Free Exploration (Analytics/Explore, unlimited) — A free-form analytics explorer that lets users build custom queries, create pivot tables, and explore data interactively.
Merchant Spend Analytics (Analytics/MerchantSpend, unlimited) — Merchant-level spend analytics showing how much is being spent at each vendor.
Top Merchants (Analytics/MerchantSpend/TopX, unlimited) — A focused view showing the top-N merchants by spend volume.
Server-Side Analytics (Analytics/ServerSide, unlimited) — Moves analytics computation to the server for tenants with very large datasets where client-side processing would be too slow.
Server-Side Analytics Explorer (Analytics/ServerSide/Explorer, unlimited) — The free-form explorer powered by server-side computation for large datasets.

Budget Management

Budgets are the financial containers that fund activities. A company allocates money into budgets, and activities draw from those budgets. Budget features control how budgets are created, structured, and managed.

Create Budget (Budget/create, benefit-card) — Allows creating new top-level budget allocations at the company level.
See Budget Details (Budget/SeeDetails, benefit-card) — View detailed budget information including allocations, utilization rates, and linked activities.
Generate Default Budgets (Budget/GenerateDefaultBudgets, startup) — Auto-generates default budget allocations for new tenants during onboarding.
Create Sub-Budget (createSubBudget, enterprise) — Create sub-budgets under an existing parent budget, enabling hierarchical budget structures (e.g., Marketing → Marketing Events, Marketing → Advertising).
Manage Budget (ManageBudget, enterprise) — Full budget lifecycle management: editing budget amounts, archiving completed budgets, and reallocating funds between budgets.
End Activities on Budget Archive (Budget/EndActivities, unlimited) — Automatically ends all activities linked to a budget when that budget is archived, preventing further spend.
Disable Parent Budget Validation (Budget/disableParentValidation, unlimited) — Disables the validation that prevents child budgets from exceeding their parent budget's total. Used in scenarios where sub-budgets are managed independently.
Dynamic Budget Tags (Budget/DynamicTags, unlimited) — Enables dynamic tag-based breakdowns within budgets, allowing spend to be categorized by tag type for more granular reporting.
Emergency Budget (EmergencyBudget, light) — Allows rapid creation of emergency budgets for urgent, unplanned spend needs.

Card Management

Card features control the issuance, configuration, and lifecycle of physical and virtual payment cards. Cards are the payment instruments employees use to spend against their activities.

Issuance

Order Cards (Card/OrderCards, light) — Enables the card ordering flow for managers and admins to request new cards for employees.
Physical Card (Card/PhysicalCard, light) — Enables issuance of physical (plastic) cards that are mailed to the employee or office.
Virtual Card (Card/VirtualCard, light) — Enables issuance of virtual (digital-only) cards for online transactions. Virtual cards are available instantly.
Expedited Card Delivery (Card/ExpeditedDelivery, unlimited) — Adds an option for expedited shipping when ordering physical cards.
International Card Shipping (Card/ShipInternationally, unlimited) — Allows shipping physical cards to international addresses outside the issuer's home country.

Configuration & Features

Change Card Modes (Cards/ChangeModes, benefit-card) — Allows switching a card's transaction mode between online-only, POS-only (in-person), or combined mode.
Unbind Activities from Card (Card/UnbindActivities, benefit-card) — Removes the binding between a card and its linked activities, allowing the activities to be used with any card.
Apple Pay Support (Card/ApplePay, enterprise) — Enables employees to add their Custodia cards to Apple Pay for contactless payments.
Google Pay Support (Card/GooglePay, enterprise) — Enables employees to add their Custodia cards to Google Pay for contactless payments.
Card State Change Notifications (Card/NotifyStateChange, unlimited) — Sends notifications to the cardholder and/or manager when a card's state changes (e.g., activated, blocked, expired).
Issue 3rd Party Token (Card/3rdPartyToken, unlimited) — Generates tokenized card credentials for use with third-party payment gateways, enabling programmatic payments without exposing the actual card number.

Expense Management

Expense features control how card transactions are viewed, categorized, edited, and processed after they occur. Expenses are the records of actual spend — every card swipe or online purchase creates an expense.

Viewing & Editing

View Expenses (Expenses, benefit-card) — The core expense list page. Shows all transactions for the user's scope (own expenses, team expenses, or company-wide depending on role).
Edit Expense (Expenses/Edit, benefit-card) — Allows editing expense transaction details like notes, tags, and categorization.
Detailed Expense View (Expenses/View/Detailed, benefit-card) — Expands each expense to show full transaction information, receipt images, OCR data, and the complete audit trail.
Edit Expense Accounting Details (Expenses/EditAccountingDetails, benefit-card) — Allows editing the GL account code, cost center, and project assignment on individual expenses.
Edit Expense After Approval (Expenses/ChangeAfterApprove, enterprise) — Allows editing expense details even after the expense has been approved in the workflow. Normally, approved expenses are locked.
Edit Expense Subsidiary (Expenses/EditSubsidiary, enterprise) — Allows changing which subsidiary an expense is attributed to, relevant for multi-entity organizations.
Mass Update Expenses (Expenses/MassUpdate, enterprise) — Bulk-update multiple expenses at once (e.g., reassign cost centers, change GL codes, update tags).

Receipts

Attach Receipt to Expense (Expenses/AttachReceipt, light) — Allows users to upload receipt images or PDFs and attach them to expense transactions.
Report Missing Receipt (Expenses/Receipt/ReportMissing, enterprise) — Allows users to formally report a receipt as missing, triggering the company's missing receipt policy.
Missing Receipts Management (MissingReceipts, enterprise) — A dedicated view showing all expenses across the company that are missing receipt documentation, for finance team follow-up.

Splitting & Reassignment

Split Expenses (Expenses/Split, enterprise) — Split a single expense into multiple line items, each with its own GL code, cost center, and amount. Useful when a single purchase spans multiple budget categories.
Split Expenses Across Owners (Expenses/Split/AcrossOwners, benefit-card) — Split an expense across multiple employee owners, distributing the cost among participants (e.g., a group meal).
Split Expense by VAT (Expense/Split/ByVAT, unlimited) — Automatically splits expenses into their VAT/tax and net components based on OCR data or configured tax rates.
Reassign Expenses to Activities (Expenses/Reassign/Activities, benefit-card) — Move an expense from one activity to another, useful when a transaction was charged to the wrong activity.
Transfer Expense (Expenses/Transfer, benefit-card) — Transfer ownership of an expense from one user to another entirely.

Personal Expenses & Review

Mark Expense as Personal (Others) (Expenses/Edit/markPersonal, startup) — Allows a manager or admin to mark another user's expense as personal (non-business), excluding it from company reporting.
Mark Own Expense as Personal (Expenses/Edit/markPersonalSelf, startup) — Allows users to mark their own expenses as personal.
Expense User Review Step (Expenses/UserReview, unlimited) — Adds an extra review step where the cardholder must explicitly confirm/review the expense before it moves to manager approval.
Expense Reimbursement (Expenses/Payment, enterprise) — Enables the reimbursement workflow for out-of-pocket expenses, allowing employees to submit personal spend for company reimbursement.

Company Administration

These features control the company-level administration pages and settings. They determine what setup and configuration options are available to company admins and finance teams.

Company General Setup (Company/Admin, benefit-card) — Access to the company general setup area, including basic company information and preferences.
Company Dashboard (Company/Dashboard, benefit-card) — A company-level dashboard showing aggregate spend metrics, budget utilization, and activity summaries across all employees.
Company Expenses (Company/Expenses, startup) — A company-wide expenses view that lets finance teams see and manage all expenses across the organization, not just their own team.
Company Finance Admin (Company/Finance/Admin, benefit-card) — Finance administration area including chart of accounts, GL mappings, and accounting configuration.
Company Statements (Company/Statements, benefit-card) — Billing period summaries showing transaction totals, fees, and settlement amounts.
Tenant Bank Accounts (Company/Admin/BankAccounts, startup) — Manage the company's bank account details used for reimbursement payments and billing.
Subsidiaries (Company/Admin/Subsidiaries, benefit-card) — Manage subsidiary entities for organizations with multiple legal entities or branches. Expenses and budgets can be attributed to specific subsidiaries.
Dictionary (Company/Admin/Dictionary, enterprise) — A custom dictionary system for tenant-specific labels and terminology. Allows renaming UI elements and creating custom activity types.
Products (Company/Admin/Products, enterprise) — Product catalog management for categorizing expenses by product/service type.
Profiles (Company/Admin/Profiles, enterprise) — Spend profile administration that defines per-employee spend limits and rules based on role or seniority.
Projects (Company/Admin/Projects, enterprise) — Project management for tracking expenses and activities against specific projects or cost objects.
Purchase Orders (Company/Admin/PurchaseOrders, enterprise) — Purchase order import and management, linking expenses back to approved POs.
Identity Management Sync (Company/IDM, unlimited) — Synchronize with external identity management systems (e.g., Active Directory, Okta) for automated user provisioning, deprovisioning, and attribute sync.

Activity Template Editor

The template editor allows company admins to create and configure activity types (templates). Each template defines default settings for activities of that type — budget parameters, merchant restrictions, receipt requirements, and more. All template editor features require unlimited license.

Activity Template Editor (Company/Activity/TypesEditor) — The master toggle that enables the template editor UI. Without this, admins cannot create or edit activity templates.
Create New Templates (Company/Activity/TypesEditor/CreateNewType) — Allows creating entirely new activity templates in the editor (vs. only editing existing ones).
General Settings (Company/Activity/TypesEditor/GeneralSettings) — Enables the general settings tab (name, description, default duration, default budget) in the template editor.
Advanced Settings (Company/Activity/TypesEditor/AdvancedSettings) — Exposes advanced settings like auto-extend, auto-lock, and buffer configuration.
Card-Present Mode (Company/Activity/TypesEditor/CardPresent) — Allows configuring card-present (in-person only) mode as a default for a template.
Categories (Company/Activity/TypesEditor/Categories) — Enables spend category configuration within templates.
Classifications (Company/Activity/TypesEditor/Classifications) — Enables classification tagging within templates.
Daily Limit (Company/Activity/TypesEditor/DailyLimit) — Enables daily spending limit configuration as a template default.
Transaction Limit (Company/Activity/TypesEditor/TransactionLimit) — Enables per-transaction spending limit configuration as a template default.
Merchants (Company/Activity/TypesEditor/Merchants) — Enables merchant restriction (allow/block lists) configuration in templates.
Photos (Company/Activity/TypesEditor/Photos) — Enables photo/receipt requirement configuration in templates.
Tags (Company/Activity/TypesEditor/Tags) — Enables tag assignment configuration in templates.
Recurring Payment (Company/Activity/TypesEditor/RecurringPayment) — Enables recurring payment mode as a configurable option in templates.
Rollover Budget (Company/Activity/TypesEditor/RolloverBudget) — Enables rollover budget configuration (unused budget carries forward to the next period) in templates.

Company Policies

Policy features control the company's configurable spend rules. Policies define approval workflows, spending limits, receipt requirements, and other guardrails. They are managed centrally and apply across the organization.

Policy Manager (Company/Policy/PolicyManager, benefit-card) — The centralized policy manager page where admins view and edit all company policies in one place.
Approval Policy (Company/Policy/Approval, benefit-card) — Configures multi-level approval workflows for activity requests. Defines who needs to approve, at what thresholds, and in what order.
Activity Permission Policy (Company/Policy/ActivityPermission, benefit-card) — Defines which roles can create, edit, and approve activities. Controls the permission matrix for activity operations.
Buffer/Margin Policy (Company/Policy/BufferPolicy, benefit-card) — Configures a buffer (margin) that allows activities to exceed their budget by a configured percentage before being declined. Useful for handling exchange rate fluctuations or tips.
Currency Configuration (Company/Policy/CurrencyConfiguration, benefit-card) — Multi-currency configuration including supported currencies, exchange rate sources, and conversion rules.
Card Limits Policy (Company/Policy/CardLimits, light) — Defines card-level spending limits (daily, monthly, per-transaction) independent of activity limits.
Receipt Requirements Policy (Company/Policy/ReceiptRequirements, enterprise) — Configures when receipts are required based on expense type, amount thresholds, and merchant category.
Justification Requirements (Company/Policy/JustificationRequirements, enterprise) — Requires employees to provide a written justification for expenses exceeding configurable thresholds.
Out-of-Pocket Policy (Company/Policy/OutOfPocketPolicy, enterprise) — Configures the rules for out-of-pocket expense reimbursement: eligible expense types, maximum amounts, and required documentation.
Spend Category Limits (Company/Policy/SpendCategory, enterprise) — Sets discretionary spending limits per spend category (e.g., max $500/month on dining).
Travel Policy (Company/Policy/Travel, enterprise) — Travel expense rules including maximum hotel rates, flight class restrictions, and mileage reimbursement rates.
Per Diem and Meals Policy (Company/Policy/PerDiemAndMeals, enterprise) — Per diem and meal allowance configuration by destination, role, and trip duration.
Decision Tables (Company/Finance/DecisionTables, enterprise) — Rule-based tables that automatically route and categorize expenses. For example: "If merchant category is Airlines AND amount $1000, set GL code to 6200 and require manager approval."

Employee & Team Management

These features control how employee profiles are managed, what managers can edit, and how team structures work.

Employee Profile Editing

Edit Employee Details (manager/employee/editDetails, benefit-card) — Allows managers to edit general details on employee profiles (name, phone, employee ID, etc.).
Edit Employee Address (Employee/editAddress, benefit-card) — Allows editing address fields on employee profiles, used for card shipping.
Edit Employee Teams (manager/employee/editTeams, benefit-card) — Allows managers to change an employee's team assignments.
Edit Employee Roles (manager/employee/editRoles, benefit-card) — Allows managers to change an employee's role and spend profile assignments.
Edit Employee Cost Centers (manager/employee/editCostCenters, benefit-card) — Allows managers to change an employee's cost center assignments.
Change OAuth Status (Employee/ChangeOauthStatus, benefit-card) — Allows admins to change an employee's OAuth/SSO authentication status (e.g., link or unlink SSO).

Merchant Blocking

View Blocked Merchants (Employee/BlockMerchants, benefit-card) — Shows the blocked merchants section on employee profiles, displaying which merchants are blocked for that employee.
Edit Blocked Merchants (Employee/BlockMerchants/Edit, benefit-card) — Allows adding and removing merchants from an employee's blocked list.

Teams & Delegation

Team Dashboards (Team, benefit-card) — Team-level dashboards showing aggregated spend, activities, and expenses for a manager's direct reports.
Team Notifications (Team/Notifications, enterprise) — Enables notifications for team-level events such as budget utilization thresholds, pending approvals, and expense anomalies.
User Delegation (Delegates/Delegate, unlimited) — Allows a user to delegate their data visibility and approval abilities to another user (e.g., when out of office).
Employee Payments (EmployeePayments, enterprise) — Enables the employee reimbursement and payment processing module for out-of-pocket expenses.

User Identity & Authentication

These features control how users are identified, how they log in, and security-related administration.

Identify Users by Email (User/UseEmail, benefit-card) — Enables email-based user identification and login. When enabled, emails are the primary way users log in.
Email Required (User/emailRequired, benefit-card) — Makes the email field mandatory on user profiles. Without this, email is optional.
Username is PII (User/UserNameIsPII, benefit-card) — Marks the username field as personally identifiable information, applying additional privacy protections (masking in logs, restricted access).
Identify Users by Username (User/UseUserName, unlimited) — Enables username-based login as an alternative to email. Used in scenarios where employees don't have individual email addresses.
Temporary Password (User/TempPassCode, unlimited) — When inviting a user, sends a temporary password in addition to the standard magic login link. Useful for employees who have trouble with email-based login links.
Activate User on Card Order (User/ActivateOnCardOrder, unlimited) — Automatically activates a user account and sends them login credentials when a card is ordered for them, streamlining onboarding.
Security Administration (IT/Security, benefit-card) — Access to the security administration page, including SSO/OAuth configuration, IP restrictions, password policies, and security audit logs.

Operations & Automation

Operations features are backend automations and integrations typically configured by Custodia support or the card issuer. They run on schedules or in response to events, and are almost exclusively unlimited tier (must be explicitly granted).

Scheduled Reports (Operations/ScheduledReports, unlimited) — Create reports that run automatically on a cron schedule and deliver results via email. Supports various report types (expenses, budgets, activities) with configurable filters and recipients.
Upload Receipts to S3 (Operations/ReceiptToS3, unlimited) — Automated batch upload of receipt files to an Amazon S3 bucket for archival or integration with external document management systems.
- Approved Expenses Only (Operations/ReceiptToS3/RequireApprovedExpenses) — Restricts the S3 upload to only include receipts from approved expenses.
- PDF Format Required (Operations/ReceiptToS3/RequirePDF) — Converts receipt images to PDF format before uploading to S3.
SFTP to S3 Transfer (Operations/SFTPToS3, unlimited) — Automated file transfer from an SFTP endpoint to S3, used for exchanging data files with external systems.
Missing Receipts Admin Report (Operations/Reports/Admin/MissingReceipts, unlimited) — Sends automated periodic emails to admins listing all expenses with missing receipt documentation.
Block All Notifications (Operations/BlockAllNotifications, unlimited) — Blocks all outgoing notifications (email, push, SMS) for a tenant. Used during migrations, testing, or when the tenant manages their own notifications externally.
Create Teams from Subsidiaries (Operations/CreateTeamsFromSubsidiaries, unlimited) — Automatically creates team structures based on the tenant's subsidiary hierarchy, keeping teams in sync with the organizational structure.
Fix Expenses Without Activities (Operations/FixExpensesWithNoActivities, unlimited) — An automated fix for orphaned expenses that are not linked to any activity. This can happen during edge cases in transaction processing.
Managed Workflows (Operations/ManagedWorfklow, unlimited) — Enables workflows that are managed and configured from the parameters system rather than hardcoded, allowing support to customize workflows per tenant.

Mobile App

These features control functionality specific to the Custodia mobile app (iOS/Android).

Smart Receipt Recognition (App/SmartReceiptRecognition, unlimited) — AI-powered receipt scanning and data extraction using OCR. Users photograph a receipt and the system automatically extracts the merchant name, amount, date, and line items.
Advanced Receipt Editing (App/AdvancedReciptEditing, unlimited) — Enables advanced receipt editing capabilities in the mobile app, including cropping, rotating, adjusting, and annotating receipt images.
Private to Business (App/PrivateToBusiness, unlimited) — Allows employees to convert private (personal) transactions to business expenses from the mobile app, initiating a reimbursement request.
PO Consolidation (App/Consolidate, unlimited) — Purchase order consolidation from the mobile app, allowing users to group multiple receipts/expenses into a single purchase order.
Card Selection in Onboarding (Onboarding/Issuance/SelectCard, unlimited) — Allows employees to choose their preferred card type (physical, virtual, or both) during the in-app onboarding flow.
Disable Onboarding Screens — Three features that suppress individual onboarding screens for tenants that want a streamlined first-launch experience:
- App/DisableFirstOnboarding — Suppresses the welcome/introduction screen.
- App/DisableSecondOnboarding — Suppresses the card information screen.
- App/DisableThirdOnboarding — Suppresses the spend tutorial screen.

HelpDesk & Support Portal

These features control the card-issuer helpdesk and the internal Custodia support portal. They are used by support agents, not by tenant employees.

Card Issuer HelpDesk

HelpDesk Access (HelpDesk, benefit-card) — The core access feature for the card issuer helpdesk interface.
Free Text Search (HelpDesk/NameSearch, benefit-card) — Enables free-text search across employee names in the helpdesk, allowing agents to quickly find cardholders.
View User Info (HelpDesk/UserInfo, benefit-card) — View detailed user information including card status, activity history, and account details.
Companies Section (HelpDesk/Companies, unlimited) — Adds a companies section to the helpdesk for viewing and managing company-level information.
View Company Info (HelpDesk/CompanyInfo, unlimited) — View detailed company information including license tier, feature configuration, and usage statistics.

Custodia Support Portal

These features are for internal Custodia support staff only (support tier).

Support Portal (Support) — Access to the main Custodia support portal.
New Company Enrollment (Support/Enrollment) — The company enrollment wizard for onboarding new tenants.
Billing Statements (Support/Billing) — Billing statement management and generation.
Custodia Payments (Support/Payments) — Payment processing and reconciliation tools.
Security Logs Access (Support/Security) — Access to cross-tenant security audit logs.

Miscellaneous Features

Additional platform features that don't fit neatly into the categories above.

View Transactions (Transactions, benefit-card) — Core feature to view raw card transactions (authorizations, settlements, reversals) before they become expenses.
Languages (languages, benefit-card) — Enables multi-language support for the tenant. When enabled, users can switch the UI language. Supported languages depend on the partner configuration.
Send Emails (Mail/Send, benefit-card) — Enables the platform to send emails on behalf of the tenant (notifications, receipts, reports). When disabled, no emails are sent.
Import Files (ImportFiles, benefit-card) — Enables the file import system for bulk data operations like importing employees, cost centers, or GL codes from spreadsheets.
Debug Info (DebugInfo, benefit-card) — Shows debug information in the UI for troubleshooting purposes. Typically enabled only for support or during issue investigation.
Info Pages (InfoPages, startup) — Content management system for creating help pages, FAQs, and informational content within the platform that users can access.
Trip Request (Trip, unlimited) — Enables the trip request activity type, allowing employees to submit travel requests with itinerary details that bundle multiple expense categories (flights, hotels, meals).
Subscriptions Management (Subscriptions, unlimited) — Enables tracking and management of recurring subscription payments, identifying repeated charges and providing subscription oversight.
Distance Matrix (DistanceMatrix, unlimited) — Enables distance calculations for mileage-based expense claims, using mapping APIs to compute travel distances between addresses.
Notification Setup (NotificationSetup, unlimited) — Enables the notification configuration page where admins can customize which notifications are sent, to whom, and through which channels.
Mass Reimbursement Payments (Reimbursements/MassPayment, unlimited) — Process multiple employee reimbursements in a single batch operation, generating a payment file for bank submission.
Dwolla Mass Payments (Dwolla/MassPayment, unlimited) — Mass payment processing through the Dwolla payment platform for US-based ACH reimbursements.
Custom Period Selection (CustomPeriodSelection, light) — Allows users to select custom date ranges for viewing data beyond the standard billing period boundaries.
Block Company Merchants (BlockCompanyMerchants, enterprise) — Enables company-level merchant blocking, preventing all employees from transacting at specified merchants.

Related to