xMatix
Sign in Request demo
xMatix
PRODUCTS
SalesField Sales & SFACRMRewardsClaimsInventoryProcurementWarehouse ManagementField ServiceServiceSupportTelephony & MessagingFinance & AccountingPayrollExpense ManagementCommercePortalsAnalytics & ReportingData StudioMobile AppSee all products →
PLATFORM
Platform overviewApp BuilderAutomationIntegrationsSecurity & GovernanceChange ManagementDevelopers
SENSE AI
Sense AI overviewSense AssistSense ControlSense VisionAI StudioTrust & governanceIn Claude & ChatGPTUse cases
SOLUTIONS
Auto DMSConsumer Goods DMSSales Force Automation (SFA) FMCG & DistributionManufacturing & Dealer NetworksAutomotive & DealershipsPharma & HealthcareConsumer DurablesAgri-InputsBuilding MaterialsService NetworksWarehousing & 3PLFinancial AccountingERP SoftwareIndia GST ComplianceUAE VAT & e-InvoicingSaudi ZATCA & VATAll solutions →
RESOURCES
Knowledge CenterDeveloper & CLIBlogGuidesWhat is xMatix?Company facts
COMPANY
AboutCareersPartnersEventsContactAuthorsLegal
Sign in Request demo
Home/Docs/Entity Reference/Grade — entity reference
REFERENCE · Last reviewed

Grade — entity reference

A seniority band, such as Officer, Manager or Director, given to people through the Grade field on their Resource record. Its only effect is expense policy scoping: every expense policy names one grade, and Evaluate Policy applies a policy to a claim only when the policy's grade is the grade on the claim's Resource. Rank, Code, Description, Is Active and Partner Account are never compared. The grade on the payroll Employee record is not read. Grades are listed in the Expense List app under Dimensions. The standard Create Grade form has no Name field, so Name must be added to the form before a grade can be saved.

Fields

FieldLabelTypeRequiredWhat it does
CodeCodeTextOptional short code for the grade, up to 40 characters, for imports or reference. No process reads it.
CreatedByIdCreated ByLookup → UserAccountYes
CreatedDateTimeCreated DateDateAndTimeYes
DescriptionDescriptionTextOptional text describing the grade. Shown on the Create Grade form (also used for Edit); the standard record page does not show it. No process reads it.
IdIdGuidYes
IsActiveIs ActiveBooleanWhether the grade is still in use. Information only: inactive grades still appear in the Grade pickers and policies that name them still apply to people who carry them. To retire a grade, move its people and policies to another grade first.
ModifiedByIdModified ByLookup → UserAccountYes
NameNameText, uniqueYesThe grade's name, shown in the Grade pickers on resources and expense policies. Required and unique across the organization. The standard Create Grade form does not include it, so a new grade is refused with 'Name is required' until an administrator adds Name to that form.
OwnerIdOwnerLookup → UserAccountYes
PartnerAccountIdPartner AccountLookup → AccountThe company the grade was set up for, picked from the organization's own companies. Recorded only: it is not used to match expense policies, and any grade can be used on any resource or policy. Hidden when the organization runs one company.
RankRankNumberOptional whole number for ordering grades by seniority; by convention a higher rank is more senior. No process reads it: expense policies match the grade record itself, so a higher rank never inherits another grade's limits.
RecordTypeIdRecord TypeGuid, hidden
UIPropsUI PropsText
UpdatedDateTimeModified DateDateAndTimeYes

Actions

ActionLabelTypeWhat it does
BulkDeleteDeleteDeleteDelete the selected records.
CloneCloneServerAction (Clone)Create a copy of this record
DeleteDeleteDeleteDelete this Grade.
DeleteRecordDeleteDeleteDelete
EditEditEditEdit this Grade.
EditRecordEditEditEdit
NewNewNewCreate a Grade.

Lookup filters

FilterLookup fieldNotes
PartnerAccountFilterPartnerAccountId