# 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="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"> `modal` block
3. Click on 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"> `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="menu" %}
[menu](https://docs.cwicly.com/blocks/menu)
{% 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="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"> `modal` block
3. Click on 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"> `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="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"> `modal` block
3. Click on 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"> `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="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"> `modal` block
3. Click on 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"> `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="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"> `modal` block
3. Click on 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"> `modal` block to insert it into your page
4. Find Layout Tab
5. Click dot(s) to reset

</details>

{% content-ref url="../design/layout" %}
[layout](https://docs.cwicly.com/design/layout)
{% 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="modal/modal-style" %}
[modal-style](https://docs.cwicly.com/blocks/modal/modal-style)
{% 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="modal/settings" %}
[settings](https://docs.cwicly.com/blocks/modal/settings)
{% 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="modal/trigger" %}
[trigger](https://docs.cwicly.com/blocks/modal/trigger)
{% 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="modal/animation" %}
[animation](https://docs.cwicly.com/blocks/modal/animation)
{% endcontent-ref %}
