Documentation Index
Fetch the complete documentation index at: https://help.statisfy.com/llms.txt
Use this file to discover all available pages before exploring further.
Object Manager
The Object Manager is your central hub for configuring Statisfy’s data model. Manage fields across all entity types, set up products and dimensions, configure CRM sync, and create custom objects.Accessing Object Manager
Navigate to Settings > Object Manager (app.statisfy.com/settings?tab=object-manager). You need admin permissions to access this page.Entity Tabs
The Object Manager is organized by entity type. Select a tab at the top to manage that entity:| Tab | Description |
|---|---|
| Accounts | Customer account fields |
| Opportunities | Deal and opportunity fields |
| Projects/Tasks | Project and task fields (with per-task-type configuration) |
| People | Contact and person fields |
| Activity | Activity and interaction fields (with per-activity-type configuration) |
| Product | Product catalog and usage dimensions |
| Custom Objects | User-defined entity types |
Field Categories
Within each entity tab (except Product and Custom Objects), fields are organized into collapsible sections. Each section shows a badge with the field count.Standard Fields
Built-in fields provided by Statisfy. These cannot be deleted or renamed, but you can configure visibility, mandatory status, and CRM mapping.
Statisfy Fields
Custom fields you’ve created to capture additional data specific to your business needs. Fully editable and deletable.
CRM Fields
Fields synced from your connected CRM (Salesforce, HubSpot, etc.). Grouped by source. Includes upstream sync toggle for bidirectional sync.
Supported Field Types
| Type | Description |
|---|---|
| Text | Single-line text |
| Long Text | Multi-line text area |
| Number | Integer values |
| Float | Decimal values |
| Currency | Monetary values |
| Percent | Percentage values |
| Percent Ratio | Stored as decimal, displayed as percentage (e.g., 0.2 displays as 20%) |
| Boolean | True/false toggle |
| Date | Date values |
| URL | Web links |
| Picklist | Single-select dropdown with predefined options |
| Multi-Picklist | Multi-select dropdown with predefined options |
| Pill | Color-coded labels (like tags) |
| Object | Nested fields (expandable in the UI) |
| Lookup | Reference to another entity |
| Lookup List | List of references to another entity |
| Text List | List of text values |
Creating a Custom Field
- Select the entity tab (e.g., Accounts)
- Click + Create Field in the top-right corner
- Choose the field type
- Configure the field name, description, and options
- Click Save
Editing a Field
Click the edit icon on any field to open the Edit Field dialog. The available options depend on the field type and whether it’s a standard, Statisfy, or CRM field.Options for Statisfy (Custom) Fields
| Setting | Description |
|---|---|
| Display Name | The label shown in the UI |
| Editable | Whether users can modify this field’s value on records |
| Upstream CRM Field | Map this field to a CRM field for inbound sync |
Options for CRM Fields
| Setting | Description |
|---|---|
| Downstream Statisfy Field | Map this CRM field to a Statisfy custom field (CRM → Statisfy) |
Options for Opportunity and Projects/Tasks Fields
These entity types have additional field-level controls:| Setting | Description |
|---|---|
| Hidden | Hide the field from the UI entirely |
| Mandatory | Make the field required (only applies when the field is editable and not hidden) |
| Filter Conditions | When mandatory is enabled, optionally define conditions for when the field is required (e.g., only mandatory for certain opportunity stages) |
Picklist and Pill Options
For picklist (dropdown) fields and pill (colored label) fields, the edit dialog includes an options editor where you can add, remove, and reorder the available choices. Pill options also support setting a custom color for each value.Formula Fields
Formula fields are special custom fields whose values are computed automatically from an expression you define. They are read-only — users cannot edit their values directly.Equation
Write custom expressions with fields, functions, and operators. Supports arithmetic, string operations, conditionals (IF/CASE), and 30+ built-in functions.
Rollup
Aggregate values from related entities — SUM, COUNT, MIN, MAX, AVG, MEDIAN, FIRST, LAST, CONCAT, or COLLECT_UNIQUE — with optional filters.
Cross-Object
Pull a field value from a related entity (e.g., parent account name, CSM email) with optional text transforms.
Time Calculation
Calculate time differences — days until renewal, time since last activity, or duration between two dates.
Creating a Formula Field
- Select an entity tab and click + Create Field
- Choose a field type (Text, Number, Date, Boolean, Currency, etc.)
- Check This is a formula field and click Save
- The formula editor opens — select a formula type and configure it
- Use Validate to check for errors, Preview to test against real records, then Save
Available Relationships for Rollups
Rollup and cross-object formulas traverse relationships to access related data. The available relationships depend on the entity type:| Entity | Relationships |
|---|---|
| Account | parent, children, descendants, csm, owner, opportunities |
| Opportunity | account, owner |
| People | account |
| Task | account, assignee |
| Product Usage | account |
Editing a Formula Field
Formula fields show an Edit Formula link in the field edit dialog. Click it to open the dedicated formula editor where you can modify the expression, change the formula type, or update filters and aggregations.For the full formula reference — including all functions, operators, aggregation types, filter operators, and examples — see the dedicated Formula Fields guide.
Deleting a Custom Field
- Click the delete icon on the Statisfy field you want to remove
- Confirm the deletion in the dialog
CRM Sync Configuration
Upstream Sync Toggle
For CRM field sections (Salesforce, HubSpot), an upstream sync checkbox appears in the section header. This controls whether fields are synced from your CRM into Statisfy for that entity type.Field Mapping
You can map fields between Statisfy and your CRM in two directions:- Upstream CRM Field — On Statisfy custom fields, select which CRM field should populate this field (CRM → Statisfy)
- Downstream Statisfy Field — On CRM fields, select which Statisfy custom field this CRM field should populate (CRM → Statisfy)
Projects/Tasks and Activity: Sub-Type Configuration
For Projects/Tasks and Activity entities, fields can be configured per sub-type (e.g., per task type or per activity type). This allows you to:- Show or hide a field for specific task/activity types
- Make a field mandatory only for certain types
- Associate custom fields with specific sub-types
Products & Dimensions
The Product tab has a dedicated interface for managing your product catalog and usage dimensions.Creating a Product
- Go to the Product tab
- Click + Create Product
- Fill in the product details:
| Field | Required | Description |
|---|---|---|
| Name | Yes | Internal identifier for the product (e.g., platform_pro) |
| Display Name | No | Human-readable label shown in the UI (e.g., “Platform Pro”) |
| Snapshot Period | Yes | How often usage data is captured — Daily, Weekly, Monthly, Quarterly, or Yearly |
| Date Column Label | No | Label for the date column in product usage data. Auto-populated based on snapshot period |
| Date Format | No | Format string for dates. Auto-populated based on snapshot period (e.g., %m/%Y for Monthly) |
- Click Save
Editing a Product
Click the pencil icon on a product card to open the edit dialog and update its settings.The snapshot period configured on a product is used by CSV Import integrations. If you change it here, any linked CSV integrations will use the updated period.
Deleting a Product
To delete a product from the catalog:- Navigate to the Product tab in Object Manager
- Click the delete icon on the product card
Deleting Dimensions
To remove dimensions and all their associated data from a product:- Click Delete Dimensions on the product card
- A warning dialog will appear — review it carefully, as this action removes both the dimensions and all associated usage data
- Confirm to proceed
Clearing Dimension Data
To remove usage data for a product’s dimensions while keeping the dimensions themselves:- Click Clear Dimension Data on the product card
- A warning dialog will appear — review it carefully, as this action removes all stored usage data for the product’s dimensions
- Confirm to proceed
Managing Dimensions
Dimensions are measurable attributes associated with a product (e.g., active users, storage used, API calls). Each product card shows its dimensions below the product details.Adding a Dimension
- Click + Add Dimension on the product card
- Enter the dimension name
- Select the dimension type:
| Type | Description |
|---|---|
| Numeric | Integer or decimal values |
| String | Text values |
| Date | Date values |
| Boolean | True/false values |
| Percent | Percentage values (displayed with %) |
| Percent Ratio | Stored as decimal, displayed as percentage (e.g., 0.2 → 20%) |
- Configure display settings (see below)
- Click Save
Dimension Display Configuration
When creating or editing a dimension, you can configure how values are displayed:| Setting | Applies to | Description |
|---|---|---|
| Hide from Widget | All types | Hides this dimension from the product usage widget |
| Show % Change | Numeric only | Shows period-over-period percentage change |
| Format Currency | Numeric only | Formats values as currency |
| Suffix | All (editable for non-percent) | Appended to values (e.g., “users”, “GB”). Auto-set to ”%” for percent types |
| Date Format | Date only | Custom date format string (e.g., %Y-%m-%d) |
Reordering Dimensions
Drag and drop dimensions using the grip handle to change their display order on the product usage widget.Dimension Visibility
Toggle the eye icon on a dimension to show or hide it from the product usage widget without deleting it.Custom Objects
Custom objects let you create entirely new entity types beyond the standard ones. Creating a Custom Object:- Navigate to the Custom Objects tab
- Click Create Custom Object
- Define the object name and description
- Add fields to capture relevant data
- Save the custom object
Custom objects are an advanced feature. Contact your Statisfy account team if you need guidance on structuring custom objects for your use case.