Skip to main content

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:
TabDescription
AccountsCustomer account fields
OpportunitiesDeal and opportunity fields
Projects/TasksProject and task fields (with per-task-type configuration)
PeopleContact and person fields
ActivityActivity and interaction fields (with per-activity-type configuration)
ProductProduct catalog and usage dimensions
Custom ObjectsUser-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

TypeDescription
TextSingle-line text
Long TextMulti-line text area
NumberInteger values
FloatDecimal values
CurrencyMonetary values
PercentPercentage values
Percent RatioStored as decimal, displayed as percentage (e.g., 0.2 displays as 20%)
BooleanTrue/false toggle
DateDate values
URLWeb links
PicklistSingle-select dropdown with predefined options
Multi-PicklistMulti-select dropdown with predefined options
PillColor-coded labels (like tags)
ObjectNested fields (expandable in the UI)
LookupReference to another entity
Lookup ListList of references to another entity
Text ListList of text values

Creating a Custom Field

  1. Select the entity tab (e.g., Accounts)
  2. Click + Create Field in the top-right corner
  3. Choose the field type
  4. Configure the field name, description, and options
  5. Click Save
The new field appears under the Statisfy Fields section.

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

SettingDescription
Display NameThe label shown in the UI
EditableWhether users can modify this field’s value on records
Upstream CRM FieldMap this field to a CRM field for inbound sync

Options for CRM Fields

SettingDescription
Downstream Statisfy FieldMap 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:
SettingDescription
HiddenHide the field from the UI entirely
MandatoryMake the field required (only applies when the field is editable and not hidden)
Filter ConditionsWhen 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

  1. Select an entity tab and click + Create Field
  2. Choose a field type (Text, Number, Date, Boolean, Currency, etc.)
  3. Check This is a formula field and click Save
  4. The formula editor opens — select a formula type and configure it
  5. Use Validate to check for errors, Preview to test against real records, then Save
The formula editor provides autocomplete (type @), a searchable function picker, syntax highlighting, and real-time parsed previews as you type.

Available Relationships for Rollups

Rollup and cross-object formulas traverse relationships to access related data. The available relationships depend on the entity type:
EntityRelationships
Accountparent, children, descendants, csm, owner, opportunities
Opportunityaccount, owner
Peopleaccount
Taskaccount, assignee
Product Usageaccount

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

  1. Click the delete icon on the Statisfy field you want to remove
  2. Confirm the deletion in the dialog
Deleting a custom field permanently removes it and all stored values across all records. Standard and CRM fields cannot be deleted.

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

  1. Go to the Product tab
  2. Click + Create Product
  3. Fill in the product details:
FieldRequiredDescription
NameYesInternal identifier for the product (e.g., platform_pro)
Display NameNoHuman-readable label shown in the UI (e.g., “Platform Pro”)
Snapshot PeriodYesHow often usage data is captured — Daily, Weekly, Monthly, Quarterly, or Yearly
Date Column LabelNoLabel for the date column in product usage data. Auto-populated based on snapshot period
Date FormatNoFormat string for dates. Auto-populated based on snapshot period (e.g., %m/%Y for Monthly)
  1. Click Save
When you change the snapshot period, the date column label and date format are automatically updated to sensible defaults. You can override them if needed.

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:
  1. Navigate to the Product tab in Object Manager
  2. Click the delete icon on the product card
You cannot delete a product that has dimensions. The delete button will be disabled with a tooltip explaining why. To delete such a product, you must first delete all its dimensions (see below), then delete the product.

Deleting Dimensions

To remove dimensions and all their associated data from a product:
  1. Click Delete Dimensions on the product card
  2. A warning dialog will appear — review it carefully, as this action removes both the dimensions and all associated usage data
  3. Confirm to proceed
After deleting dimensions, the product’s delete button becomes enabled if you also want to remove the product itself.

Clearing Dimension Data

To remove usage data for a product’s dimensions while keeping the dimensions themselves:
  1. Click Clear Dimension Data on the product card
  2. A warning dialog will appear — review it carefully, as this action removes all stored usage data for the product’s dimensions
  3. Confirm to proceed
After clearing, the dimensions remain configured on the product but contain no associated data. New data can be imported again via CSV or integrations.

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

  1. Click + Add Dimension on the product card
  2. Enter the dimension name
  3. Select the dimension type:
TypeDescription
NumericInteger or decimal values
StringText values
DateDate values
BooleanTrue/false values
PercentPercentage values (displayed with %)
Percent RatioStored as decimal, displayed as percentage (e.g., 0.2 → 20%)
  1. Configure display settings (see below)
  2. Click Save

Dimension Display Configuration

When creating or editing a dimension, you can configure how values are displayed:
SettingApplies toDescription
Hide from WidgetAll typesHides this dimension from the product usage widget
Show % ChangeNumeric onlyShows period-over-period percentage change
Format CurrencyNumeric onlyFormats values as currency
SuffixAll (editable for non-percent)Appended to values (e.g., “users”, “GB”). Auto-set to ”%” for percent types
Date FormatDate onlyCustom 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:
  1. Navigate to the Custom Objects tab
  2. Click Create Custom Object
  3. Define the object name and description
  4. Add fields to capture relevant data
  5. Save the custom object
Custom objects appear in the navigation and can be used in views, filters, and workflows.
Custom objects are an advanced feature. Contact your Statisfy account team if you need guidance on structuring custom objects for your use case.