Field Groups

Field Groups let you store structured groups of data input in your Tangram application. Each listing type and role in your platform is a field group. By default, most Tangram platforms come loaded with a few pre-built field groups in the form of roles and listing types. You can create new roles and listing types on your own, or create custom field groups to add structured groups of data to your existing roles.

Types of Field Groups

Tangram provides several built-in field group types:

  • Roles - Define user types and their associated data (e.g., Landlord, Tenant, Agent)
  • Listing Types - Define various types of listings and their properties (e.g., Apartment, Office Space, Event Venue)
  • Custom Field Groups - Additional data structures you can create for specialized needs
Working with Field Groups

Field Groups provide several important capabilities:

  • Structure - Organize related fields together in a logical way
  • Validation - Apply rules to ensure data integrity
  • API Access - Easily access and manipulate data through the Tangram API
  • User Interfaces - Automatically generate forms and displays based on field groups
  • Relationships - Connect different types of data across your application
Creating Custom Field Groups

To create a custom field group:

  1. Navigate to the Data section in your Tangram admin panel
  2. Select "New Field Group"
  3. Give your field group a name and description
  4. Add fields to the group by defining their types and properties
  5. Configure any validation rules or relationships
  6. Save your field group
Best Practices

When designing field groups, consider these recommendations:

  • Group related fields together for better organization
  • Use clear, descriptive names for field groups and fields
  • Consider how field groups will be used in your application flows
  • Plan field group relationships to avoid data duplication
  • Start simple and add complexity as needed