# Custom Query Tag
A query allows you to display items from any collection on any page of your site. A Squarespace Query can be filtered by several parameters.

**Important:** the contents of a `<squarespace:query>` is not cached and may increase page load time. There is a hard limit of eight queries per page and 100 results per query.

## Querying Items

To initiate a Squarespace Query, add the query tag to your collection page with one more parameters. All parameters are optional except for `collection`. All code inside of the opening and closing query tags will inherit the scope set by the parameters.

```html
<squarespace:query collection="new-blog" limit="10">

  <ol>
    {.repeated section items}
      <li><a href="{fullUrl}">{title}</a></li>
    {.end}
  </ol>

</squarespace:query>
```

### Parameters

* `collection=""` The collection URL ID (slug) to query *(required)*
* `limit=""` The number of items you'd like returned *(number, max 100)*
* `skip=""` The number of returned items you'd like to skip *(number, max 10)*
* `category=""` Only return items that have this category *(comma delimited)*
* `tag=""` Only return items that have this tag *(comma delimited)*
* `featured=""` Filters the return to show only Featured posts. *(boolean)*

## Example

This example demonstrates how to create a featured item module that is flexible enough to be used on any .list file. To achieve that flexibility we'll pull in the collection URL dynamically.

```html
blog.list
----------------------------

<squarespace:query collection="{.section collection}{urlId}{.end}" featured="true" limit="5">

  <div class="featured-wrapper">
    {.repeated section items}
    <div class="featured-post">
      {.main-image?}<img {@|image-meta} />{.end}
      <h2>{title}</h2>
    </div>
    {.end}
  </div>

</squarespace:query>
```