We have moved!

You are currently looking at documentation for Umbraco 8 and older versions.
An automated guess is that docs.umbraco.com/umbraco-cms/fundamentals/backoffice/property-editors/built-in-property-editors/related-links could be the link to the new documentation for Umbraco 9 and newer versions.

    (Obsolete) Related Links

    For the new version of this data type see: Related-Links2

    Returns: RelatedLinks if value converters are enabled (default)

    Returns: JArray if value converters are disabled

    Related Links allows an editor to add an array of links. These can either be internal Umbraco pages or external URLs.

    Data Type Definition Example

    Related Links Data Type Definition

    Content Example

    Media Picker Content

    MVC View Example - value converters enabled

    Typed

    @using Umbraco.Web.Models
@{
    var typedRelatedLinksConverted = Model.Content.GetPropertyValue<RelatedLinks>("footerLinks");

    if (typedRelatedLinksConverted.Any())
    {
        <ul>
            @foreach (var item in typedRelatedLinksConverted)
            {
                var linkTarget = (item.NewWindow) ? "_blank" : null;
                <li><a href="@item.Link" target="@linkTarget">@item.Caption</a></li>
            }
        </ul>
    }
}

    MVC View Example - value converters disabled

    Typed

    @using Newtonsoft.Json.Linq
@{
    if (Model.Content.HasValue("relatedLinks") && Model.Content.GetPropertyValue<string>("relatedLinks").Length > 2)
    {
        <ul>
            @foreach (var item in Model.Content.GetPropertyValue<JArray>("relatedLinks"))
            {
                var linkUrl = (item.Value<bool>("isInternal")) ? Umbraco.NiceUrl(item.Value<int>("internal")) : item.Value<string>("link");
                var linkTarget = item.Value<bool>("newWindow") ? "_blank" : null;
                <li><a href="@linkUrl" target="@linkTarget">@(item.Value<string>("caption"))</a></li>
            }
        </ul>
    }
}

    Dynamic

    @{
    if (CurrentPage.HasValue("relatedLinks") && CurrentPage.relatedLinks.ToString().Length > 2)
    {
        <ul>
            @foreach (var item in CurrentPage.relatedLinks)
            {
                var linkUrl = (bool)item.isInternal ? Umbraco.NiceUrl(item.Value<int>("internal")) : item.link;
                var linkTarget = (bool)item.newWindow ? "_blank" : null;
                <li><a href="@linkUrl" target="@linkTarget">@item.caption</a></li>
            }
        </ul>
    }
}