It doesn't seem to be documented anywhere yet, unfortunetly.
I have a simple example here
demonstrating foreign key columns, as well as a separate issue with group headers and foreign key columns. Namely, the text part isn't used in the group header. Also, sorting runs by the value part, not text, which can lead to unexpected results.
However, the example does show how filtering will automatically populate the available options from the column's values list.