to_name

A relationship can use to_name to indicate which name the class in the to property takes as role in this relationship. This gets used to display the answer to the user.

Example

An Issue can be created by a user, which is called in this case a Creator. This can be specified using to_name.

relationship created_by {
    display_name: "created by"
    
    to: kb.User
    to_name: "Creator"

    sql: ...
}