# Query

The `query` block is an Archive post layout that sets the options to show and categorise single posts. The `query` block is a vital part of every block-based theme and further customisations always start with the `query` block.

The `query` block requires a collection of same category posts so it is important to have these before you build your `query` block.

{% hint style="info" %}
It is recommended to add a `query` block inside a Section.
{% endhint %}

<figure><img src="https://lh6.googleusercontent.com/aQoQVRs-xv74Ksbek96fky15X0IyjlMHLbGU_Y9n58bBgdPqX0vIx05vw3tJ8N7Mmgyt8bJlyyJh87oVipb0WAaTn6iry30H7B_sBCDvqfaj4wWtmHkthdIUvdD-j9AJD6s46OaCYZH6r82rBjklmSib4evD964pOmHp4ftWtj0RNNp5Z9QiEi3Z2GeFBA" alt=""><figcaption></figcaption></figure>

<figure><img src="https://lh4.googleusercontent.com/vyCjdOjmXAISH6-nPGVO_ZzXyUkcnslzoKPH0rS8KH_OPdkiNJyXlP5D_KGdOgvzM112PUvt-Z-dMz7tk0lFCxK0q_bOpRKLVY0Eo0eo39IT8D02ICUEvmPnhzeGsziSLeZ31jSFU5sSbmIvNTofwY0zub68nIIEJynP6KZGc5hN5s8Nm-FBhyYOGF7H" alt=""><figcaption></figcaption></figure>

<details>

<summary><strong>Add</strong></summary>

1. Open the Inserter Panel&#x20;
2. Search for the <img src="https://3250709389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MS33S0eoYwMaMrLb7T_%2Fuploads%2FIFujNW2w7vGBWle7QUxI%2Ffavicon-black%20(1).png?alt=media&#x26;token=7217d37c-7da0-48b5-a775-e14b6e5de2f4" alt="" data-size="line"> `query` block
3. Click on the block to insert it into your parent block

</details>

After you add the `query` block, a modal will appear to remind you that you have to add a Query Template to a `query` block.

To add a Query Template, click on the button.

If you want to add a Pagination Wrapper (a container for page numbers), remember to add this by clicking the button before you add a Query Template.

<figure><img src="https://lh6.googleusercontent.com/JBWSGp4rXNRT6zcgDFPLZJg9W0XRbNoqMV37e4Z81RebZ2gU-x5diiG7cda2dy5XSWq9QAICDU45N-VDiSH16cZxbVCr5CsZ4i6hVl8Gxlg9QjHDgf9qwQCzgxRaBtUcSK9Jh9AxF9lcxxF6xAYV96wrrzevnPu03GuogxatWd9msN1Eq2T1WZsbpnu3Jw" alt=""><figcaption></figcaption></figure>

Once you have added the Query Template, another modal will pop up and guide you to the block inserter to add the blocks you require to the Query Template.

<figure><img src="https://lh6.googleusercontent.com/m7YCK2UoSIIQscAlpHYDVyI-5-1fiHWRnY39cCG_78vH0CTdu9lhG2FB1z0vPfD32hC-Mb7nAvYeU27KYUKDkLSHVVrftfa2furvXnL4-xpeZXbUackc-wskdlubPPbmH1uqQpnL-gKsAxpMJMKWym7-nGFmGdMcRvHOWHLVXia6iOhNcHcYkE81ThPbcA" alt=""><figcaption></figcaption></figure>

## Add Pagination Wrapper

The Add Pagination Wrapper opens a `pagination` Block inside your Query Template and opens a Pagination Placeholder.

<figure><img src="https://lh4.googleusercontent.com/KsB1YV_-2p-rjoKnD6XaRs65xUuqfdL_0I8Gta6Jm8VlJ5qqwPoolCddw-vN0MHbrEKvPrtvA4VN8TWmwEA5GQerQTP52CGZ0lUGu_YtxQP9gAdmnXszTJWFUdSElz3Mf-pIObN0VMAO_Noz3nAYCRVWq5QBJXCYjOwXS1Ay2WkisFkxfsSZ8Gc3nMbGSg" alt=""><figcaption></figcaption></figure>

The Pagination Placeholder allows you to add page numbers to your Query Template - "Add Pagination Numbers" -  or to cancel them with the "dismiss button".

<figure><img src="https://lh4.googleusercontent.com/jmO9hbaKmPcJiNs4gKHto072y9OsJwZJ6v0Mi7sNY_F6I5-Qd8w41-gsuxTpBhLE-LpOLFGGGNxitz81npSOWhqRIQg_rfwkx3wWXl8b_SwmrcPqtmtrxXQ-XaFdkW6gk5s0ZDc4nMz7x5Yod8ONpTBnEnM5dLhhCCd3lgU0nRu71WBBaTdoUG6DEu3TgQ" alt=""><figcaption></figcaption></figure>

<figure><img src="https://lh6.googleusercontent.com/bGWzrqVNxRvexf1F6elHg3-u_3RMRcpvb4tQviNbAI1Fmxo-amu9RzS_VwyY5rc8GLGfBee4WP0nvLfcGbuXm1Ual3B8WlyNSG9ZcD0YwT-EXfcR-b4dl0diZzbhdM8gYH1UH2NLj6ac3uI-TMGNGif-OzBxyWfpOrEGLJwk9I4dloug4o0XLWJxvTJphg" alt=""><figcaption></figcaption></figure>

{% embed url="<https://www.youtube.com/watch?index=9&list=PLvp2KVaJroeRvQkxxD5I6hciYc1fOJzpC&v=7W7YGnF2K0k>" %}
TTD #9 - Queries
{% endembed %}

## Query Settings

The Query Settings panel is where the query's properties are listed and the steps that can be applied to it.

<figure><img src="https://lh5.googleusercontent.com/oOCdV0NfHgLJPRZaLL93yIenqTvgASQdEL2R4AgoHFCZ7wmkYPJZ1f6YN_nFSOkDimW-yN8UK3-vt-j-L67uLJX74n_NmlKggQ55uqRxtqoYckunHcj7YySrdUw28SDZlPwlAtS2HUW09Gpe75uBRdl-wk2maQ56b9aJCkROaQIbZH0QEvZHNmS4X-LpAA" alt=""><figcaption></figcaption></figure>

{% content-ref url="query/query-settings" %}
[query-settings](https://docs.cwicly.com/blocks/query/query-settings)
{% endcontent-ref %}

## Query Editor

The Query Editor helps you to construct and modify a Wordpress Query using a structured format in which you can interactively select components.There are 4 main Query types : Post Types, Terms, Users and Products.

You can also export your Query elsewhere by copying and pasting the generated code.

<figure><img src="https://lh6.googleusercontent.com/dceEPLRErSuem0h2kbYzQyPzRbsuNBUZPN6Ox9OMQ6K0WAMp5vA0VPk1c1rosmEaXBebXR95jYmJ86Hlwy603MKiTfTQ_zv9I1_RRzXLCO6hCu9GkJo2lIMa8H7Q39mT-HJ6FiRkw0zc2_GJ7f48Q-J73GFNSy-_-Nsi-sWy8LPu85-KMsxoVqfjfrb6JA" alt=""><figcaption></figcaption></figure>

<details>

<summary>Open</summary>

1. Click on the ➕ ​​icon to open the Inserter Panel
2. Select <img src="https://3250709389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MS33S0eoYwMaMrLb7T_%2Fuploads%2FIFujNW2w7vGBWle7QUxI%2Ffavicon-black%20(1).png?alt=media&#x26;token=7217d37c-7da0-48b5-a775-e14b6e5de2f4" alt="" data-size="line"> `query` block
3. Open the Block Inspector
4. Navigate to the Primary tab
5. Find Query Editor icon
6. Click to open Query Builder Modal

</details>

{% content-ref url="query/query-editor" %}
[query-editor](https://docs.cwicly.com/blocks/query/query-editor)
{% endcontent-ref %}