From 94ee5e68e60cb6e64d2338979ac949d1f84ecb11 Mon Sep 17 00:00:00 2001
From: Monviech <79600909+Monviech@users.noreply.github.com>
Date: Fri, 5 Apr 2024 14:40:09 +0200
Subject: [PATCH] Update models_fieldtypes.rst - Add example to display
 multiple fields (#551)

---
 source/development/frontend/models_fieldtypes.rst | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/source/development/frontend/models_fieldtypes.rst b/source/development/frontend/models_fieldtypes.rst
index e6bcdb8f..f04dc85e 100644
--- a/source/development/frontend/models_fieldtypes.rst
+++ b/source/development/frontend/models_fieldtypes.rst
@@ -391,6 +391,21 @@ Define relations to other nodes in the model, such as to point the attribute :co
         </Model>
     </pipe>
 
+To display multiple fields, the :code:`display_format` is required.
+
+.. code-block:: xml
+
+    <pipe type="ModelRelationField">
+        <Model>
+            <pipes>
+                <source>OPNsense.TrafficShaper.TrafficShaper</source>
+                <items>pipes.pipe</items>
+                <display>number,description</display>
+                <display_format>%s - %s</display_format>
+            </pipes>
+        </Model>
+    </pipe>
+
 .. csv-table:: ModelRelationField
    :header: "Parameter", "Options", "Purpose"
    :widths: 30, 20, 40