# Quick Bar Action

On any webpage, you can activate the PixieBrix Quick Bar using a keyboard shortcut. By default, the Quick Bar contains a set of action menu items that run in Chrome, but you can add your own actions the further customize it.

### What does the Quick Bar look like

<figure><img src="https://2274778196-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fq123bF1HPQPV35s5vHa1%2Fuploads%2F3QfLUJeBeJZNg2whNnby%2Fimage.png?alt=media&#x26;token=35a84a1f-387f-4e23-8b66-89293e2de2cc" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Important:** By default, the CMD/CTRL + M keystrokes will trigger the Quick Bar. Follow these instructions to [changing-the-quick-bar-shortcut](https://docs.pixiebrix.com/how-to/changing-the-quick-bar-shortcut "mention").
{% endhint %}

### Configuring a mod to use Quick Bar

**Follow these steps to create and configure a Quick Bar Action:**

1. Open the [PixieBrix Page Editor](https://docs.pixiebrix.com/page-editor-guide).
2. In the left pane, click **New Mod** > **Quick Bar**.\
   ![](https://2274778196-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fq123bF1HPQPV35s5vHa1%2Fuploads%2F7cmRDflBBRPXwa05kUSa%2FCleanShot%202024-10-24%20at%2018.59.34%402x.png?alt=media\&token=6d48b979-aab2-4da8-a612-498b8ee53fb4)
3. Type a name in the **Name** field.
4. In the **Configuration** section, enter the following information:

| Field        | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Action Title | <p>Enter the name of the menu item. This is the name that displays when someone uses the shortcut.<br><br><img src="https://2274778196-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fq123bF1HPQPV35s5vHa1%2Fuploads%2FY8nlBRHDD3GxAkgukohN%2Fimage.png?alt=media&#x26;token=708ef11c-3f43-43d0-9bcf-4b716d4c7375" alt=""></p>                                                                                                                                                                                             |
| Contexts     | <p>Select one or more focus element that triggers the Quick Bar. The default option is “all”. This means that the Quick Bar action displays whenever you use the shortcut, no matter the focus. But, if you want to narrow when the Quick Bar displays, you can choose any of the following options:<br>• page • frame • selection • link • editable • image • video • audio</p>                                                                                                                                                                |
| Sites        | <p>When you specify the sites you want the Quick Bar to display, PixieBrix runs faster and more accurately. To do so, enter the URL in the Sites field. Make sure that at least one URL matches the pattern(s) you added. <br><br>You can also:<br><br>• Click the Site, Domain, HTTPS, or All URLs shortcut to insert URLs automatically. <br>• Click Add Site to enter a URL manually. <br>• Click ABC > Remove to remove a site from the list.<br><br><a data-mention href="what-are-url-match-patterns">what-are-url-match-patterns</a></p> |

5. In the **Advanced** section, enter the following information:

| Field                 | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Icon                  | <p>If you want an icon to display next to the Quick Bar, select an icon from the drop-down list.<br><img src="https://2274778196-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fq123bF1HPQPV35s5vHa1%2Fuploads%2FiWKKs2ddj4GGAwzXz7E8%2Fimage.png?alt=media&#x26;token=deb08c3d-572c-4ffe-b53d-bcdc6d93f886" alt=""></p>                                                                                                                                                       |
| Target Mode           | <p>• Select <code>eventTarget</code> to provide the Quick Bar element clicked as the source of the bricks in the pipeline.<br>• Select <code>document</code> to pass the whole HTML document as the source to the bricks in the pipeline.</p>                                                                                                                                                                                                                                                       |
| Automatic Permissions | <p>Automatic permissions determine which sites PixieBrix automatically loads so it can watch the selection/focused element. It also allows the use of CMD+M if a custom shortcut is not set up. To add or edit the URLs, enter the URLs you want to load.<br><br>You can also:<br>• click the Site, Domain, HTTPS, or All URLs shortcuts to insert URLs automatically. <br>• click <strong>Add Site</strong> to enter a URL manually. <br>• click ABC > Remove to remove a site from the list. </p> |

6. In the **Advanced: Extra Permissions** section:

* Click the **Add Allowed Origin** button in the **Sites/APIs**:
* Click the **Site**, **Domain**, **HTTPS**, or **All URLs** shortcut to insert URLs automatically.
