# Modal

The `modal` block is a popup or dialog that appears over a page's content. It can be interacted with to exit it and return to the page.

<figure><img src="https://lh5.googleusercontent.com/21g7RG3PTpRLGSdwoWc6uYD68mgExY36gVx-b_S9_cARwZYqLGCbLEBlZjAQpM6Lt_Y1hyZWHrPQ5q-gSiqbTPUIT-9xSPtbHw3_IrzKdcedaTiPw3nr1apDyTqtSR2-4SIeD7NTCrGrW-8EfaQOR8JviJldLziTcil8Cxna2cqKTGX3A936sQDTD5DL7Q" alt=""><figcaption></figcaption></figure>

## Basics

The `modal` block is essentially an overlay background and a `div` block.

<figure><img src="https://lh5.googleusercontent.com/G06ABqiEJ0YtNnin-pNbYMMXYi1JOEB2EdS3eGqoWfZOXkb_yxKc4IWw3xNPkq-U35_VGE2lbjdjM3AylGNRPf3BBrfKE1cTEk2PPDYSV-bIsCwzuRbbzzsPNyw0yUt-MORVUCVL57x-S7ryLy0hBiVcu5tOS_CJHSJ9VtDKGZp2cIF1FyeYsnOhw1vjlQ" alt=""><figcaption></figcaption></figure>

The `modal` block will appear inline (beneath or above) when using the editor so that editing is easy and intuitive. On the front-end, the `modal` block will be rendered overlaying the other elements of the page.

To hide/reveal the `modal` block, simply toggle the "eye" icon in the Cwicly Navigator.

<figure><img src="https://lh3.googleusercontent.com/WpjrDClO9aL6OX4sK_NfV2TCscACvGh_T1VGilz9zL-JrJznjqAVglartgyu-0M0_nITs18uCj2LQUSE6ILRW0q3mvP8-cpqTdgMTOI6eMIWdx_DC-eYrDPCmP_Uzwo97ZH2dG9kVx06nL21PRp16wtYw39kEqnMgZq9L8Tv4XyiRzoMkA5aGBYnWbyv3Q" alt=""><figcaption></figcaption></figure>

{% hint style="danger" %}
It is not advisable to add a `modal` block inside a parent block as this will create errors.
{% endhint %}

<figure><img src="https://lh5.googleusercontent.com/5LMh4eRXjEHk9G3-oAdh7fRt-boXs8lolD2D1o__Uv3v2fiaBIkpveIJT8Oq0EsYFPVEtOjOLRDGvkieaJMp928PIevY8OfxmKokT4B4H_4MlceAwQZWfKeuohfUEQhVTkb9VHFiTYnehhEcVaEcpmvSaLD0j9PxW-aLEe12v-T1umkBtpihh02ARgIfnw" alt=""><figcaption></figcaption></figure>

<details>

<summary>Add a modal</summary>

1. Click on the ➕ ​​icon to open the Inserter Panel
2. Search for the <img src="/files/sHJscThWb2nW7KToY5IY" alt="" data-size="line"> `modal` block
3. Click on the <img src="/files/sHJscThWb2nW7KToY5IY" alt="" data-size="line"> `modal` block to insert it into your page

</details>

## Modal Menu&#x20;

You need to add a Menu to your modal block before you style it.

With the Modal block selected, add a Menu from the Quick Inserter.

{% content-ref url="/pages/-MS3HTH15FnK2YqG3DQV" %}
[Menu](/blocks/menu.md)
{% endcontent-ref %}

<figure><img src="https://lh5.googleusercontent.com/vmgOFbEWQCUngzSViDBLRrmWyJmzN84jQOn2cPVoISEVQVtWh7UOT0GtoWwyoAsBlstzIdDtwt-Nvtcdex1NTiNiXg6-wuJD08KeBCiXIovKOmyKWtcL3lUkWFEOQwZnghmfkb-saxLTAPaVQxGDTz1wotNGQW7gX_bSFTSiYYEBu5Y8pyfHxTVP6276Aw" alt=""><figcaption></figcaption></figure>

{% embed url="<https://www.youtube.com/watch?v=V3kPBj-NrWE>" %}
How to - Modal Pop Up
{% endembed %}

## Colours

The Modal Colours tab allows you to customise the text, links and background of your modal.

<figure><img src="https://lh3.googleusercontent.com/WJACfe4PAWBwukLQ5G99Cmp6-dcI_FjyhbVDLbUePl58miafRW35rGhPnX2cjMPKpCC31gWUwiAi99Akaj_-IX95bqL2fc4r7hgD4JRU2zuG6MQ7vd5-nLbIEEFAawIk0sxAgnwPHIMpN-xKzrJrg1CzTxgYtm7K6rl2KmsIxzPSZXRZvbQEoEYGeFH4Fg" alt=""><figcaption></figcaption></figure>

<details>

<summary>Modify colours</summary>

1. Click on the ➕ ​​icon to open the Inserter Panel
2. Search for the <img src="/files/sHJscThWb2nW7KToY5IY" alt="" data-size="line"> `modal` block
3. Click on the <img src="/files/sHJscThWb2nW7KToY5IY" alt="" data-size="line"> `modal` block to insert it into your page
4. Find Colours Tab
5. Open to modify text, links and background colours

</details>

<details>

<summary>Reset colours</summary>

1. Click on the ➕ ​​icon to open the Inserter Panel
2. Search for the <img src="/files/sHJscThWb2nW7KToY5IY" alt="" data-size="line"> `modal` block
3. Click on the <img src="/files/sHJscThWb2nW7KToY5IY" alt="" data-size="line"> `modal` block to insert it into your page
4. Find Colours Tab
5. Click dot(s) to reset modal colours

</details>

## Inner Layout

The Modal Inner Layout tab allows you to modify your modal inner layout and includes: display, direction, position, behaviour, text size, spacing.

<figure><img src="https://lh4.googleusercontent.com/No_L5EdzhyF_8zy6MHc37L3y2i42_KFsMiDfN18tbMPnJVY3S6Q8Riqi5aNEVw1fAyOKdb6mF7t7D09FoxhZHGSU5nm-lWNfEqgZhyhV3mxdhpvCGMOWIi1yrYYOwGY0wbzCR3dxTj51OwX8n6H9UDK2BcRDe-EMJiqJ-AceN7KXvuWUJHxjVOfB4AKOyA" alt=""><figcaption></figcaption></figure>

<details>

<summary>Modify inner layout</summary>

1. Click on the ➕ ​​icon to open the Inserter Panel
2. Search for the <img src="/files/sHJscThWb2nW7KToY5IY" alt="" data-size="line"> `modal` block
3. Click on the <img src="/files/sHJscThWb2nW7KToY5IY" alt="" data-size="line"> `modal` block to insert it into your page
4. Find Layout Tab
5. Open to modify inner layout (display, direction, position, behaviour, text size, spacing)

</details>

<details>

<summary>Reset inner layout</summary>

1. Click on the ➕ ​​icon to open the Inserter Panel
2. Search for the <img src="/files/sHJscThWb2nW7KToY5IY" alt="" data-size="line"> `modal` block
3. Click on the <img src="/files/sHJscThWb2nW7KToY5IY" alt="" data-size="line"> `modal` block to insert it into your page
4. Find Layout Tab
5. Click dot(s) to reset

</details>

{% content-ref url="/pages/-MS3GcvF\_fB9BagGqxUY" %}
[Layout](/design/layout.md)
{% endcontent-ref %}

## Modal Style

The Modal Style properties allow you to customise the look and feel of the modal window, for example: Overlay colour, Height, Width, Position.

<figure><img src="https://lh3.googleusercontent.com/BMQImFqRKtEPCP8SK48fGzNRnn2IChwx93tUXX8i0DhYVmPBuNzd4ozgEcxwu6NktckNmD5UyDIQCj8jhr_9GMGhm0oAp2jlN9vmRxKYRBy9hwDVspbtmS2hBowxqjpScalNbh4uGZz3NgEPOniBr2pksE03Q80YshiqU0wtN8198pwmE9hQK5fOeBMs6Q" alt=""><figcaption></figcaption></figure>

{% content-ref url="/pages/nyGV44XXmdeM9Ynrz6MU" %}
[Modal Style](/blocks/modal/modal-style.md)
{% endcontent-ref %}

## Settings

The Modal Settings properties allow you to customise the interactions users can have with the Modal.

<figure><img src="https://lh6.googleusercontent.com/UIbuUiPrr2uzFqHJSWV4Aj_o09Uvn3qAto0bxdpgHpyXcsR1bxtm3khZMS7cRzUoO1H1Bl3f55gXTsxWSwt0nN47bO6A_WvNHfbhIHJvfSMgxfXAYukHNk4Ywu4akAi1QhmVqtcV94beLREmv6DF_5ZOpWuNTR7KxMxsUUj1MQxLVse6bEFXK4PUhngWEg" alt=""><figcaption></figcaption></figure>

{% content-ref url="/pages/uEig60c1Qb3RDZpx8H3k" %}
[Settings](/blocks/modal/settings.md)
{% endcontent-ref %}

## Trigger

The modal trigger tab allows you to set the modal's block trigger settings.

<figure><img src="https://lh4.googleusercontent.com/KsU5utj3uf7LvzITkBRe-g_1HClPV5-ztwMhxUJr6VKFG5_2O_Rq_Rg6GBRLAw0tnlm9n9GyiL-NPS_hKeVzDc37NmvFn3tXWZr7iB3HI7jGBu4G94vPRKECsj69V9y2n4pwHdPqBK46sFeHdun911I0pvp-9JQW-tjqWF1kYa0dVRTJt3Eh7bQd1QSuSg" alt=""><figcaption></figcaption></figure>

{% content-ref url="/pages/bKCHfuM7tnN9DjzuHF80" %}
[Trigger](/blocks/modal/trigger.md)
{% endcontent-ref %}

## Animation

Animate the modal block's appearance and disappearance, with specific transition durations.

<figure><img src="https://lh5.googleusercontent.com/JhARVN9upLzJZMhmxOBKJWlyL5jJTD8CPBBwcRRxmKs6-Md8F3KVbeqYF4gFGeozHzkQejvkK_B2d4YHZB2hrVHFV6hoj9L-jTCluJIE86ikVoWJQubLZA64T2GdNff8SBkvbFYGmxpHNBWof0NTjBDEftC8EfEJErlq7xf8gHaHD9NTqgW1IgznyDWKmg" alt=""><figcaption></figcaption></figure>

{% content-ref url="/pages/tusEunnuO0X18t2I1zVr" %}
[Animation](/blocks/modal/animation.md)
{% endcontent-ref %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.cwicly.com/blocks/modal.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.