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.
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 accessto 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.
Add a reference
Open the database app, open the app menu, and select
Customize record layout.Click
+or type/in a text block.Under
Database, selectTwo-way referenceorReferences.For
Two-way reference, choose the relation to show in the list that opens.Referencesis added right away as the blockRelated records.
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.
For a two-way reference:
Reference: the relation the block shows.Limit:No limitor1 Record. Choosing1 RecordasksChange limit to 1 record?, because only the first linked record is kept.
For references:
Sort: orders the records by one or more fields. SelectAdd sort. Tape adds a rule with an app and a field, for example "Tasks : Title". Change the field if needed and chooseAscendingorDescending.References: choose which sources to show or hide, withHide allandShow all.Group: underGroup by, chooseData sourceorDate.With
Data source, you can turn onShow app iconandHide empty groups, and sort the groupsManual,Alphabetical, orReverse alphabetical.With
Date, choose the date field underGrouping fieldsand sort the groupsNewest firstorOldest first. Records without a date appear underNo date, and future ones underUpcoming.
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?
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?
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?
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?
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?
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?
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?
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 →.
