# Breakpoints

Breakpoints are the building blocks of responsive design.

Custom breakpoints allow you to define specific points in your design where the layout adjusts to ensure optimal viewing on different devices. Cwicly makes this process incredibly intuitive and flexible.

By default, Cwicly ships with 3 breakpoints. Desktop which is the base breakpoint, Tablet and Mobile.

## Switch Views

To switch from one breakpoint to another, you can either hover and click or click and drag from the edge of the canvas.

### Responsive Selector

The Responsive Selector allows you to change breakpoints from the top bar of the editor.

* In the editor, find the Responsive Selector icon in the top bar .&#x20;
* Hover and click the required breakpoint in the dropdown.

<figure><img src="https://3250709389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MS33S0eoYwMaMrLb7T_%2Fuploads%2F7gOdzyIujQzgsajEOJL8%2Fresponsive%20selector%20new.jpg?alt=media&#x26;token=999a422a-6e64-42f1-b37c-c6b9edf95d5a" alt=""><figcaption></figcaption></figure>

### Drag Visualisation

The drag visualisation offers a real-time preview of your website to explore and control full responsiveness.

* In the editor, hover over either edge of the canvas.&#x20;
* A drag icon and bar will appear.
* Drag canvas to required breakpoint.

<figure><img src="https://3250709389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MS33S0eoYwMaMrLb7T_%2Fuploads%2FZiCvM3b60Fh91LFWRDbU%2Fdrag%20canvas.jpg?alt=media&#x26;token=4822c756-6f23-4d7a-bb6c-e25b4a5e192f" alt=""><figcaption></figcaption></figure>

## Width Presets Bar

To know where you are at all times, the width presets bar shows the current breakpoint and the canvas width.

* With the Drag Visualisation in use, find the Width Presets Bar at the top of the canvas.
* The current breakpoint and canvas width are displayed.

<figure><img src="https://3250709389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MS33S0eoYwMaMrLb7T_%2Fuploads%2Fq24vbfpr090NGidJfvnm%2Fwidth%20preset%20bar.jpg?alt=media&#x26;token=d28d51ad-e150-474c-81d4-677ab20f58f8" alt=""><figcaption></figcaption></figure>

### Resize Canvas

Additionally, hover and click to resize your canvas to commonly used screen sizes.

* Find the Width Presets Bar at the top of the canvas.
* Hover and click the required breakpoint/canvas size.

<figure><img src="https://3250709389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MS33S0eoYwMaMrLb7T_%2Fuploads%2Fh0wysMgDWhUZPESSOhOB%2Fsnapdragon.jpg?alt=media&#x26;token=b482fccf-3b18-454a-b259-cbf977a9ecfc" alt=""><figcaption></figcaption></figure>

## Snap to Breakpoint

The snap to breakpoint property allows you to resize your canvas to commonly used screen sizes.

* Click the transition point to snap the canvas to the breakpoint’s largest width.

<figure><img src="https://3250709389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MS33S0eoYwMaMrLb7T_%2Fuploads%2F3q6vRk6FTmmEC48JOHeV%2Fsnap%202%20.jpg?alt=media&#x26;token=b7e1e6cc-fda8-48d2-9257-d19e407dcc68" alt=""><figcaption></figcaption></figure>

## Breakpoint Information

Information about the breakpoint and its transition point is available at the edge of the current breakpoint.

<figure><img src="https://3250709389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MS33S0eoYwMaMrLb7T_%2Fuploads%2FkQ5RVuhK3EQXqQ5cd7oI%2Finformation%20break%20and%20transition%20point.jpg?alt=media&#x26;token=a87b3821-cf56-434d-975d-f4e1980329e9" alt=""><figcaption></figcaption></figure>

## Breakpoints Manager

The Breakpoints Manager allows you to customise your breakpoints. It also  lists all the currently available breakpoints on your installation and displays its icon, name, transition point and status.

### Open

* To open, hover over the breakpoints selector in the Responsive Selector.
* Click to open the Breakpoints Manager.

{% hint style="danger" %}
When modifying breakpoints, remember to regenerate your block and global class CSS.
{% endhint %}

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

<figure><img src="https://3250709389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MS33S0eoYwMaMrLb7T_%2Fuploads%2FsvEGxSSki8sxwxQTRXCi%2Fbreakpoints%20manager.jpg?alt=media&#x26;token=c53b4e2f-4b89-4e6f-af39-32a10256b094" alt=""><figcaption></figcaption></figure>

### Icon

The Icon for each breakpoint is displayed to the left of the name.

<figure><img src="https://3250709389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MS33S0eoYwMaMrLb7T_%2Fuploads%2F196t2PKMbdH5UVkeooLA%2Ficons%20breakpoints%20manager.jpg?alt=media&#x26;token=d2e7deea-44d2-411a-b219-3d15fa5d59a7" alt=""><figcaption></figcaption></figure>

### Name

The breakpoint name is displayed after the Icon.<br>

<figure><img src="https://3250709389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MS33S0eoYwMaMrLb7T_%2Fuploads%2Fy6NZFx6vSDjlQeLJzfdE%2Fname%20breakpoints%20manager.jpg?alt=media&#x26;token=362a3551-3aa5-4e34-9b26-eef156a23f57" alt=""><figcaption></figcaption></figure>

### Transition Point

The Transition Point is the maximum width at which the breakpoint applies.

<figure><img src="https://3250709389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MS33S0eoYwMaMrLb7T_%2Fuploads%2FKuRG2YqgjyLTLQCLdZKD%2Ftransky%20point.jpg?alt=media&#x26;token=85744b7d-2c30-4a44-bdb1-825b0b7020a6" alt=""><figcaption></figcaption></figure>

### Status

The Status icon indicates whether a breakpoint is active or not.

* Find the Breakpoint you wish to enable or disable.
* Toggle the Status icon as required.

<figure><img src="https://3250709389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MS33S0eoYwMaMrLb7T_%2Fuploads%2FT4OIcYCo63lj2luAYv6L%2Fstatus%20visible.jpg?alt=media&#x26;token=eda20212-281a-4a2f-a1c1-8931059ce041" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
The Status indicator does not apply to the default Breakpoints shown below.
{% endhint %}

<figure><img src="https://3250709389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MS33S0eoYwMaMrLb7T_%2Fuploads%2F9NrmeUhFJmKcJEWqVTDk%2Fstatus%20breakpoints%20manager.jpg?alt=media&#x26;token=f2b7077b-4b2e-4001-aa52-7ae704d06340" alt=""><figcaption></figcaption></figure>

### Base Tag

The base tag indicates that properties applied to this breakpoint will automatically apply to all screen sizes.

Cwicly automatically sets the correct min-width and max-width media queries for each breakpoint depending on the position of the base tag.

<figure><img src="https://3250709389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MS33S0eoYwMaMrLb7T_%2Fuploads%2F00F8EaxTDzbodLPL0Tmb%2Fbase%20breakpoints%20manager.jpg?alt=media&#x26;token=ac437007-8b0c-456b-a210-ca2b2c8935f0" alt=""><figcaption></figcaption></figure>

## Modify

A Breakpoint can be modified from the Breakpoints Manager. You can modify  the Icon, the Name, whether the Base is enabled or not, the Width, the Editing Width.

* Open the Manager.
* &#x20;the Breakpoint you wish to modify.
* Click the Modify icon in the Breakpoints Manager to open the Modify Breakpoint modal.

<figure><img src="https://3250709389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MS33S0eoYwMaMrLb7T_%2Fuploads%2FsiGpYElJeomGGWf2YwSH%2Fmodify%20a%20breakpoint.jpg?alt=media&#x26;token=00f2f149-209e-493c-ad30-c17c43b4435d" alt=""><figcaption></figcaption></figure>

### Base

When you set a new base breakpoint, Cwicly will automatically convert the above breakpoints to min-width media queries.

* Open the  Manager
* Click the Modify icon next to the breakpoint you wish to define as Base.
* Toggle Base as required.

<figure><img src="https://3250709389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MS33S0eoYwMaMrLb7T_%2Fuploads%2Fnkg3zbUTKkQ1PVoOr3xP%2Fbase%20toggle.jpg?alt=media&#x26;token=74e38338-3d0c-42d3-8ac4-0cc5a26891e7" alt=""><figcaption></figcaption></figure>

### Icon

You can modify the Icon associated with a breakpoint.

* Open the  Manager
* Click the Modify icon next to the required breakpoint.
* Select required Icon.

<figure><img src="https://3250709389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MS33S0eoYwMaMrLb7T_%2Fuploads%2FgQdrXHVleNbNn3pzo5W0%2Fmodify%20icon.jpg?alt=media&#x26;token=a81cc5cb-c923-41c0-93be-8328e2227c48" alt=""><figcaption></figcaption></figure>

### Name

You can modify the Name associated with a breakpoint.

* Open the  Manager
* Click the Modify icon next to the required breakpoint.
* Input new Name.

<figure><img src="https://3250709389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MS33S0eoYwMaMrLb7T_%2Fuploads%2FrAKpj01dkBCZSkVyF9fH%2Fmodify%20name.jpg?alt=media&#x26;token=d579d77f-5fe8-4122-aae3-e5411e11e350" alt=""><figcaption></figcaption></figure>

### Width

You can modify the transition point Width associated with a breakpoint.

* Open the  Manager
* Click the Modify icon next to the required breakpoint.
* Input new Width.

<figure><img src="https://3250709389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MS33S0eoYwMaMrLb7T_%2Fuploads%2Fygz3v9D5dvFOeGD5QMH7%2Fmodify%20width.jpg?alt=media&#x26;token=256356e5-b313-4033-a338-5ed9edb867e4" alt=""><figcaption></figcaption></figure>

### Editing Width

You can modify the Editing Width associated with a breakpoint.&#x20;

This allows you to specify the canvas width you wish to snap to while editing the breakpoint.

* Open the  Manager
* Click the Modify icon next to the required breakpoint.
* Input new Editing Width.

<figure><img src="https://3250709389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MS33S0eoYwMaMrLb7T_%2Fuploads%2FaCyL8otj8NixO8nOZSwE%2Fmodify%20editing%20width.jpg?alt=media&#x26;token=ad1828b7-a9bf-4aa1-bb54-d37fa7b436e9" alt=""><figcaption></figcaption></figure>

### Modify Button

The Modify Button allows you to apply the changes you have made to a breakpoint.

* Open the  Manager
* Click the Modify icon next to the required breakpoint.
* Modify as required.
* Click the Modify Button to apply the changes.

## Add New Button&#x20;

The Add new buuton allows you to create a new breakpoint. In the Add Breakpoint modal, you can specify the Icon, Name, transition point Width, the Editing Width.

* Click the "+ Add New" button in the Breakpoints manager to open the Add Breakpoint modal.
* Specify an Icon, Name, Width and Editing Width as required.
* Click the Create Button to apply.

<figure><img src="https://3250709389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MS33S0eoYwMaMrLb7T_%2Fuploads%2FGugnQPqK5Lhxjv5agEF6%2Fclick%20create.jpg?alt=media&#x26;token=26abea01-5bab-432b-b582-79bbe2a97ae5" alt=""><figcaption></figcaption></figure>

The newly created breakpoint will now be listed in the Breakpoints Manager.

<figure><img src="https://3250709389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MS33S0eoYwMaMrLb7T_%2Fuploads%2FQFBy46UDyaOHpWlRx2uu%2Flisted%20breakpoint.jpg?alt=media&#x26;token=5f46f289-0e70-4490-85e9-72b8cb379c19" alt=""><figcaption></figcaption></figure>

## Remove

A breakpoint can be removed using the Breakpoints Manager.

{% hint style="info" %}
Note that the Default Breakpoints cannot be removed.
{% endhint %}

* Open the Breakpoints Manager.
* Click the Modify icon next to the breakpoint you wish to remove.
* Click the Bin icon to remove.

<figure><img src="https://3250709389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MS33S0eoYwMaMrLb7T_%2Fuploads%2FXSfuL7sjoeiiTIyaW5w0%2Fremove%20breakpoint.jpg?alt=media&#x26;token=1b8b3992-839d-4437-8890-837bcc608f2e" alt=""><figcaption></figcaption></figure>

## Import/Export

If you wish to import or export all breakpoints, use the copy/paste icons.&#x20;

{% hint style="info" %}
Please note that importing breakpoints will override your existing breakpoints.
{% endhint %}

<figure><img src="https://3250709389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MS33S0eoYwMaMrLb7T_%2Fuploads%2FAex980qiJmFwM3kZPtAM%2Fcopy%20paste%20breakpoint.jpg?alt=media&#x26;token=8b645e14-db3c-4d1d-91ba-b4d34741170f" alt=""><figcaption></figcaption></figure>

## Custom CSS Breakpoints

If you wish to add your own custom CSS to specific breakpoints, you can use the media breakpoint shortcuts.&#x20;

These shortcuts are smart and will automatically update the breakpoint width value according to your current settings.

* To add a property to a specific breakpoint:
* Select a block.
* In the Block Inspector, open the Advanced tab.
* In the CSS window, start typing "media".

<figure><img src="https://3250709389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MS33S0eoYwMaMrLb7T_%2Fuploads%2FMuE6iBXjfMLs8e7P1W3Z%2Fpicaxe%20massacre.jpg?alt=media&#x26;token=3e7dee49-d34b-4f8a-add5-a4b2757fc97c" alt=""><figcaption></figcaption></figure>

* A selection of breakpoints will appear, select as required.
* Add required styles.

<figure><img src="https://3250709389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MS33S0eoYwMaMrLb7T_%2Fuploads%2FiGIrzPwtwh2oe24j22XG%2Fmedia%20css.jpg?alt=media&#x26;token=cb6ab7cd-064c-49b8-b88c-da973ac6d6d6" alt=""><figcaption></figcaption></figure>

Whenever your breakpoint width changes, your custom css reflects the changes.

## Role Editor and Breakpoints

If you wish to, you can hide the Gutenberg Responsive Icon and Width Presets.

### Gutenberg Responsive Icon

The preview/responsive toggle provided by the Gutenberg team can be toggled off to avoid confusion.

* Navigate to the Role Editor.
* Toggle Gutenberg Responsive Icon as required.

<figure><img src="https://3250709389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MS33S0eoYwMaMrLb7T_%2Fuploads%2FbLQYaeWyawqS2SFQ8zfs%2Fhide%20gutenberg%20responsive.jpg?alt=media&#x26;token=c9bdfacf-22f7-4bd0-a5b9-51b3a0195b70" alt=""><figcaption></figcaption></figure>

### Width Presets

Width presets allow you to rapidly change the width of the canvas to match common device sizes.

* Navigate to the Role Editor.
* Toggle Width Presets as required.

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

<figure><img src="https://3250709389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MS33S0eoYwMaMrLb7T_%2Fuploads%2FdN9UZhlfGsuEraU8hpr3%2Fhide%20width.jpg?alt=media&#x26;token=b592cab2-76db-4aa8-93fb-5b095c5cc77c" alt=""><figcaption></figcaption></figure>

## Keyboard Shortcuts

To switch between breakpoints quickly and efficiently.

* Hold CTRL + the breakpoint order integer (1, 2, 3 etc.)

## Force iFrame

Gutenberg does not trigger iFrame mode when certain conditions are not met. For a more fluid design experience, force iFrame mode for the selected post types (Posts, Pages, Patterns).

{% content-ref url="../themer/role-editor/force-iframe" %}
[force-iframe](https://docs.cwicly.com/themer/role-editor/force-iframe)
{% endcontent-ref %}

## Client  Canvas View

The base breakpoint will be used as the default view inside the Editor but for writing content you might want to choose a specific breakpoint.

For instance if the base breakpoint is mobile, you can set the breakpoint of posts to  desktop.

{% content-ref url="../themer/role-editor/client-canvas-view" %}
[client-canvas-view](https://docs.cwicly.com/themer/role-editor/client-canvas-view)
{% endcontent-ref %}
