Document from Reference
This backend query would help you in retrieving information from a document reference. You will require the Document from Reference query if you have passed a document reference to a different page of the app and want to retrieve the actual document information from the reference.
In order to use this backend query, you should have:
- At least one Firestore Collection defined in your project.
Go to your project page on FlutterFlow and follow the steps below to define a Document from Reference backend query:
- 1.Select the widget (or page) on which to apply the query.
- 2.
- 3.Select the Query Type as Document from Reference.
- 4.Choose a Collection from the dropdown to which the document reference belongs.
- 5.Select the Source as the record reference name.

Defining Document from Reference Backend Query (RobinDo app template)
The document information retrieved from the backend query can now be set on the widgets present inside. Follow the steps below:
- 1.Select the widget (eg,
Text
) on which you want to set the record data. - 2.
- 3.Choose the Source as the record variable.
- 4.Under Available Options, select a field name.
- 5.You can also specify a Default Value (it is used if the record field is empty).
- 6.Click Save.
You can follow similar steps for using the record data on the other widgets as well.

Setting Query data to the Text widgets (RobinDo app template)
You can view the code that is generated by FlutterFlow in the background by going to the Developer Menu > View Code from the Tool Bar.
NOTE: This section is for users who might want to make some additional modifications to the generated code, or want to understand the code that is generated by FlutterFlow behind the scenes.
On adding the Document from Reference Backend Query, a code similar to the following will be generated:
StreamBuilder<ToDoListRecord>(
stream: ToDoListRecord.getDocument(widget.toDoNote),
builder: (context, snapshot) {
if (!snapshot.hasData) {
// widget to show while retrieving data
return Container();
}
final taskDetailsToDoListRecord = snapshot.data;
// return widget where record data can be used
return Scaffold();
}
)
- StreamBuilder helps in rebuilding the widget present inside it with the latest data. That means, whenever the document gets updated on the Firestore Collection it would reflect in the app automatically without any user interaction.
- Here,
stream
is used to listen to any changes in the document,getDocument()
method is used on the record to retrieve data. builder
is used to return a widget,snapshot.hasData
can be used to verify whether the retrieving process is complete, andsnapshot.data
is used to retrieve the document information.
- FlutterFlow app templates using Document from Reference query: RobinDo, GeekChat, and many more.
Last modified 1yr ago