Skip to main content

References & two-way references

Show the records that link to the current record. Add a two-way reference for one source database app or references for several, and group by source or date.

Written by Leo

A relation field links from one record to another. A reference shows the other direction: it lists the records of other database apps that link to the record you're looking at. References are meant to help you see everything connected to a record, such as all tasks that belong to a project, without leaving it.

A project record with the Related records block listing two tasks under the data source Tasks

Note:

  • A reference needs a relation. It only shows records that link to this record through a relation field. Learn more about the relation field →

  • References are blocks. You add them to the record layout, not as a field of their own.

  • If a relation is removed, the reference settings mark it Removed. References with existing records stay visible.

Who can use references?

  • References are available on all plans: Free, Plus, and Premium. See what each plan includes on our pricing page.

  • To add or change blocks, you need Full access to the database app and a desktop or tablet.

Two-way reference or references

  • Two-way reference: an incoming relation from one other database app. It shows related records from one data source. Useful for linked projects, contacts, or tasks.

  • References: shows related records from several data sources. You can group them by source or by date to get a complete overview or an activity timeline.

In the layout editor, the add menu filtered by Refer shows References and Two-way reference under Database

Add a reference

  1. Open the database app, open the app menu, and select Customize record layout.

  2. Click + or type / in a text block.

  3. Under Database, select Two-way reference or References.

  4. For Two-way reference, choose the relation to show in the list that opens. References is added right away as the block Related records.

Clicking + next to Property name in the layout editor, typing Refer, pointing at Two-way reference, and selecting References under Database, which adds the block Related records with Edit groups and Load empty groups

Reference settings

Click the drag handle to the left of the block (⋮⋮, or the block's style icon if it shows one) and select Edit reference or Edit references.

Opening the drag handle of Related records, selecting Edit references, Group, and Group by, and selecting Date, so the Group menu shows Grouping fields and Sort set to Newest first

The Edit references panel of Related records with Layout set to Cards, Field visibility, Sort, References, Group set to Data source, and the style settings

For a two-way reference:

  • Reference: the relation the block shows.

  • Limit: No limit or 1 Record. Choosing 1 Record asks Change limit to 1 record?, because only the first linked record is kept.

For references:

  • Sort: orders the records by one or more fields. Select Add sort. Tape adds a rule with an app and a field, for example "Tasks : Title". Change the field if needed and choose Ascending or Descending.

  • References: choose which sources to show or hide, with Hide all and Show all.

  • Group: under Group by, choose Data source or Date.

  • With Data source, you can turn on Show app icon and Hide empty groups, and sort the groups Manual, Alphabetical, or Reverse alphabetical.

  • With Date, choose the date field under Grouping fields and sort the groups Newest first or Oldest first. Records without a date appear under No date, and future ones under Upcoming.

In the block, Load more shows more records, and Expand and Collapse open and close a group. The menu of a group offers Edit groups and Hide group. Learn more about relation blocks →

FAQs

Is a reference the same as a relation field?

No. A relation field links a record to records of another database app, in one direction. A reference shows the other direction: in the linked database, it lists the records that link to the current record. You use both together: first a relation field, then a Two-way reference or References block on the other side. Learn more about the relation field →

Do I need a relation field before I can add a reference?

Yes. A reference lists records that link to this record, so another database app needs a relation field that points here. Learn more about the relation field →

Can I show references from several database apps in one block?

Yes. Use References instead of Two-way reference, and group them by Data source.

Can I show references as a timeline?

Yes, in a way. Group References by Date to see related records in date order.

Can I hide references on a record?

Yes. In the layout editor, the layout setting References decides when the built-in references of a record appear: Always show, Show after creation, or Off. The drag handle menu of that block also offers Hide references, which sets it to Off. Learn more about the layout editor →

Do references change the linked records?

No. A reference only shows them. To change a link, edit the relation field.

Are there other field types?

Yes! Database apps have fields for text, numbers, dates, members, files, relations, calculations, and more. See every field type in Intro to fields →

Still have more questions? Find answers and get help from community experts in the Tape community →.

Did this answer your question?