--- title: "Liquid objects: link" description: A link in a [menu](https://help.shopify.com/manual/online-store/menus-and-links/drop-down-menus). api_name: liquid source_url: html: https://shopify.dev/docs/api/liquid/objects/link md: https://shopify.dev/docs/api/liquid/objects/link.md --- # link A link in a [menu](https://help.shopify.com/manual/online-store/menus-and-links/drop-down-menus). To learn about how to implement navigation in a theme, refer to [Add navigation to your theme](https://shopify.dev/themes/navigation-search/navigation). ## Properties * * active [boolean](https://shopify.dev/docs/api/liquid/basics#boolean) * Returns `true` if the link is active. Returns `false` if not. A link is considered to be active if the current URL path matches, or contains, the link's [url](https://shopify.dev/docs/api/liquid/objects/link#link-url). For example, if the current URL path is `/blog/potion-notions/new-potions-for-spring`, then the following link URLs would be considered active: * `/blog/potion-notions/new-potions-for-spring` * `/blog/potion-notions` Tip The `link.active` property is useful for menu designs that highlight when top-level navigation categories are being viewed. For example, if a customer is viewing an article from the "Potion notions" blog, then the "Potion notions" link is highlighted in the menu. * child\_​active [boolean](https://shopify.dev/docs/api/liquid/basics#boolean) * Returns `true` if a link's child link is active. Returns `false` if not. A link is considered to be active if the current URL path matches, or contains, the [URL](https://shopify.dev/docs/api/liquid/objects/link#link-url) of the link. For example, if the current URL path is `/blog/potion-notions/new-potions-for-spring`, then the following link URLs would be considered active: * `/blog/potion-notions/new-potions-for-spring` * `/blog/potion-notions` * child\_​current [boolean](https://shopify.dev/docs/api/liquid/basics#boolean) * Returns `true` if current URL path matches a link's child link [URL](https://shopify.dev/docs/api/liquid/objects/link#link-url). Returns `false` if not. Note URL parameters are ignored when determining a match. Product URLs [within the context of a collection](https://shopify.dev/docs/api/liquid/filters/within) and standard product URLs are treated the same. * current [boolean](https://shopify.dev/docs/api/liquid/basics#boolean) * Returns `true` if the current URL path matches the [URL](https://shopify.dev/docs/api/liquid/objects/link#link-url) of the link. Returns `false` if not. Note URL parameters are ignored when determining a match. Product URLs [within the context of a collection](https://shopify.dev/docs/api/liquid/filters/within) are treated as equal to a standard product URL for the same product. * handle [string](https://shopify.dev/docs/api/liquid/basics#string) * The [handle](https://shopify.dev/docs/api/liquid/basics#handles) of the link. * levels [number](https://shopify.dev/docs/api/liquid/basics#number) * The number of nested levels under the link. * links array of [link](https://shopify.dev/docs/api/liquid/objects/link) * The child links of the link. ![](https://shopify.dev/images/icons/32/lightbulbscroll.png)![](https://shopify.dev/images/icons/32/lightbulbscroll-dark.png)ExampleCheck the number of links ```liquid {% for link in linklists.main-menu.links -%} {% if link.links.size > 0 -%} - {{ link.title }} ({{ link.links.size }} children)
{%- else -%} - {{ link.title }}
{%- endif %} {%- endfor %} ``` ## Output ```html - Home
- Catalog (2 children)
- Contact
``` * object * The object associated with the link. The object can be one of the following: * [`article`](https://shopify.dev/docs/api/liquid/objects/article) * [`blog`](https://shopify.dev/docs/api/liquid/objects/blog) * [`collection`](https://shopify.dev/docs/api/liquid/objects/collection) * [`metaobject`](docs/api/liquid/objects/metaobject) * [`page`](https://shopify.dev/docs/api/liquid/objects/page) * [`policy`](https://shopify.dev/docs/api/liquid/objects/policy) * [`product`](https://shopify.dev/docs/api/liquid/objects/product) * title [string](https://shopify.dev/docs/api/liquid/basics#string) * The title of the link. * type [string](https://shopify.dev/docs/api/liquid/basics#string) from a set of values * The type of the link. | Possible values | Description | | - | - | | article\_link | The link points to an article. | | blog\_link | The link points to an blog. | | catalog\_link | The link points to the [catalog page](https://help.shopify.com/manual/online-store/themes/customizing-themes/change-catalog-page). | | collection\_link | The link points to a collection. | | collections\_link | The link points to the [collection list page](https://shopify.dev/themes/architecture/templates/list-collections). | | customer\_account\_page\_link | The link points to a [customer account page](https://shopify.dev/docs/apps/build/customer-accounts/full-page-extensions). | | frontpage\_link | The link points to the home page. | | http\_link | The link points to an external web page, or a product type or vendor collection. | | metaobject\_link | The link points to a metaobject page. | | page\_link | The link points to a [page](https://help.shopify.com/manual/online-store/themes/theme-structure/pages). | | policy\_link | The link points to a [policy page](https://help.shopify.com/manual/checkout-settings/refund-privacy-tos#add-links-to-your-policies-within-pages-or-on-social-media). | | product\_link | The link points to a product page. | | search\_link | The link points to the search page. | * url [string](https://shopify.dev/docs/api/liquid/basics#string) * The URL of the link. ```json { "active": false, "child_active": false, "child_current": false, "current": false, "handle": {}, "levels": 0, "links": [], "object": {}, "title": {}, "type": "page_link", "url": "/pages/contact" } ```