Related Association Guide

Related List Association Guide

For related.association, use the Rails association name on the current model record, not a database table key.

Think: record.association_name

Examples:

• On groups (table_name: "groups"):

  • group_members
  • group_roles

• On users (table_name: "users"):

  • group_members

Example config for users -> memberships:

{
"name": "memberships",
"label": "Group Memberships",
"type": "related_list",
"widget": "related_records",
"related": {
"association": "group_members",
"display": "group.name",
"link_path": "group",
"empty_text": "No group memberships."
}
}

Notes:

• display is a dot path from each related record.
• link_path is optional; if provided, links to that target record form page.
• If association is wrong, no records will render.