# Liquid Objects: Link
A link element within a [menu](https://help.shopify.com/manual/online-store/menus-and-links/drop-down-menus).
For implementation guidance, see [Add navigation to your theme](https://shopify.dev/themes/navigation-search/navigation).
## Properties
### active
**Type:** boolean
"Returns `true` if the link is active. Returns `false` if not."
A link activates when the current URL path matches or encompasses the link's URL. For instance, viewing `/blog/potion-notions/new-potions-for-spring` activates both that exact path and `/blog/potion-notions` links.
**Use case:** Highlight navigation categories when customers browse related content.
### child_active
**Type:** boolean
"Returns `true` if a link's child link is active. Returns `false` if not."
Activation occurs when the current URL path matches or contains a child link's URL.
### child_current
**Type:** boolean
"Returns `true` if current URL path matches a link's child link URL. Returns `false` if not."
URL parameters are disregarded during matching. Product URLs within collection contexts equal standard product URLs.
### current
**Type:** boolean
"Returns `true` if the current URL path matches the URL of the link. Returns `false` if not."
URL parameters are ignored. Collection-scoped product URLs match standard product URLs.
### handle
**Type:** string
The link's handle identifier.
### levels
**Type:** number
Quantity of nested levels beneath the link.
### links
**Type:** array of link objects
Child links nested under this link.
**Example:** Displaying link counts
```liquid
{% for link in linklists.main-menu.links -%}
{% if link.links.size > 0 -%}
- {{ link.title }} ({{ link.links.size }} children)<br>
{%- else -%}
- {{ link.title }}<br>
{%- endif %}
{%- endfor %}
```
**Output:**
```
- Home
- Catalog (2 children)
- Contact
```
### object
**Type:** object
The resource associated with the link—one of: article, blog, collection, metaobject, page, policy, or product.
### title
**Type:** string
The link's display name.
### type
**Type:** string (enumerated)
Describes what the link targets:
| Value | Target |
|-------|--------|
| `article_link` | Article |
| `blog_link` | Blog |
| `catalog_link` | Catalog page |
| `collection_link` | Collection |
| `collections_link` | Collection list page |
| `customer_account_page_link` | Customer account page |
| `frontpage_link` | Home page |
| `http_link` | External page, product type, or vendor collection |
| `metaobject_link` | Metaobject page |
| `page_link` | Page |
| `policy_link` | Policy page |
| `product_link` | Product page |
| `search_link` | Search page |
### url
**Type:** string
The link's destination path.
## Example Object
```json
{
"active": false,
"child_active": false,
"child_current": false,
"current": false,
"handle": {},
"levels": 0,
"links": [],
"object": {},
"title": {},
"type": "page_link",
"url": "/pages/contact"
}
```