diff --git a/src/servala/core/models/service.py b/src/servala/core/models/service.py
index a1f4523..a06db4e 100644
--- a/src/servala/core/models/service.py
+++ b/src/servala/core/models/service.py
@@ -71,9 +71,14 @@ class Service(ServalaModelMixin, models.Model):
     logo = models.ImageField(
         upload_to="public/services", blank=True, null=True, verbose_name=_("Logo")
     )
-    # TODO schema
     external_links = models.JSONField(
-        null=True, blank=True, verbose_name=_("External links")
+        null=True,
+        blank=True,
+        verbose_name=_("External links"),
+        help_text=(
+            'JSON array of link objects: {"url": "…", "title": "…", "featured": false}. '
+            "Featured links will be shown on the service list page, all other links will only show on the service and offering detail pages."
+        ),
     )
 
     class Meta:
@@ -270,7 +275,10 @@ class CloudProvider(ServalaModelMixin, models.Model):
         verbose_name=_("Logo"),
     )
     external_links = models.JSONField(
-        null=True, blank=True, verbose_name=_("External links")
+        null=True,
+        blank=True,
+        verbose_name=_("External links"),
+        help_text=('JSON array of link objects: {"url": "…", "title": "…"}. '),
     )
 
     class Meta: