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.
<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.
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>