URL fieldtype - GraphQL integration

docs/api/graphql/graphql_queries.md

@@ -842,3 +842,7 @@
 ### Enable pagination for RelationList field type
 
 To learn how to enable pagination for RelationList field type, see the [RelationList field type reference](relationlistfield.md).
+
+### Url field type integration 
+
+To learn how to customize the URL field type when using GraphQL, see the [URL field type reference](urlfield.md#graphql-integration).

docs/content_management/field_types/field_type_reference/urlfield.md

@@ -68,3 +68,75 @@
 ### Settings
 
 This field type doesn't have settings.
+
+## GraphQL integration
+
+To access the `link` and `text` properties in GraphQL responses, set the `ibexa.graphql.schema.should.extend.ezurl` parameter to `true`.
+
+!!! note
+
+    This behaviour is enabled by default in [[= product_name =]] v5 and the parameter is removed.
+
+Compare the examples below:
+
+<table>
+<thead><tr><th scope="col">Parameter value</th><th scope="col">Request</th><th scope="col">Responses</th></tr></thead>
+<tbody>
+<tr>
+<td>Disabled</td>
+<td class="compare">
+```graphql
+{
+  content {
+    article(contentId: 76) {
+      url_field
+    }
+  }
+}
+```
+</td><td class="compare">
+```graphql
+{
+  "data": {
+    "content": {
+      "article": {
+        "url_field": "https://example.com"
+      }
+    }
+  }
+}
+```
+</td></tr>
+<tr>
+<td>Enabled</td>
+<td class="compare">
+```graphql
+{
+  content {
+    article(contentId: 76) {
+      url_field {
+        text
+        link
+      }
+    }
+  }
+}
+
+```
+</td><td class="compare">
+```graphql
+{
+  "data": {
+    "content": {
+      "article": {
+        "field68dbd09357392": {
+          "text": "Example",
+          "link": "https://example.com"
+        }
+      }
+    }
+  }
+}
+```
+</td></tr>
+</tbody></table>