# Text Widget

**Here, you can read about the Text Widget and its use cases.**

**Package information:** The Text Widget is available to **all packages** **.**

## What is the Text Widget?

The Text Widget is one of the custom content Widgets provided in the Happeo CMS. It is one of the most used Widgets and can be used for writing text, adding images, making bulleted and numbered lists, and adding horizontal lines.

## Text Widget options

- **Header text**: Header text is optional, but if not used, header spacing cannot be deleted
- **Body text**: Here, you can type the body text. You can also add additional content through **Quick add / insert**    - A plus symbol will show to the left of the text widget when on a new line. This will allow you to insert an **image**, **video**, **table**, **bullet points**, **numbered list**, **horizontal line,** and **code**
    - You can also double-click the text to change the font, color, etc.

**Text highlight**: If text is highlighted, you can change the font, insert a link, change alignment, bold, italics, underline, strikethrough, text color, quote, bullet points, numbered list, alignment, and clear style

**Note about "Quick add":** The **code** option in **quick add** enables you to show code without it being executed. This option is purely to display code.

**Note about using hashtags:** Using hashtags **will not work** in the Text Widget.

**Note about adding Google email:** If you wish to add a **Google email** (for contact details) as a hyperlink, we suggest that you use the link below instead of the standard mailto link. Using the alternative link will ensure that a user's browser settings don't impact the opening process when clicking the link.

Here's the link (replace the email with your email):

- [https://mail.google.com/mail/u/0/fs=1&tf=cm&source=mailto&to=firstname.lastname@happeo.com](https://mail.google.com/mail/u/0/fs=1&tf=cm&source=mailto&to=firstname.lastname@happeo.com)
- If the above link only opens a user’s inbox, you can use this link instead that will prompt a draft to open in Gmail: [mailto:firstname.lastname@happeo.com?subject=Your%20Subject%20Here&body=Your%20message%20body%20here](mailto:firstname.lastname@happeo.com?subject=Your%20Subject%20Here&body=Your%20message%20body%20here)

## Creating tables

When you **insert a table into the text widget**, you can do the following:

### Basic editing

- **Adding content**– Simply click on a cell to begin typing
- **Formatting text** – Use the text formatting options (bold, italic, strikethrough) to style your text within a cell  
  - **Mac shortcuts**    - Cmd+B for **Bold**  
    - Cmd+I for **Italics**  
    - Cmd+S for **Strikethrough**  
  - **Windows shortcuts**    - Ctrl+B for **Bold**  
    - Ctrl+I for **Italics**  
    - Ctrl+S for **Strikethrough**
- **Background color**– Add a background color to a cell using the color picker or by inputting a HEX code
- **Text alignment**– Align text within a cell to the left, right, center, or justify. You can also vertically align text to the top, middle, or bottom

### Table styling

- **Table style** – Customize the overall appearance of your table with options like alternating row colors, rounded corners, padding, highlighting the first row, and border visibility
- **Cell merging and splitting** – Merge cells to combine multiple cells into one or split cells to create multiple cells from one

### Table structure

- **Moving columns** – Select a cell within the column you want to move. A drag icon will appear at the top of the column. Click and drag this icon to your desired position
- **Moving rows** – Similar to columns, select a cell within the row you want to move. A drag icon will appear on the left side of the row. Click and drag this icon to reposition the row
- **Inserting a new row** – Select a cell within the row where you want to add a new row. Click the + icon above or below the cell to insert a new row
- **Deleting a row** – Select a cell within the row you want to delete. Click the trash can icon to remove the entire row
- **Inserting a new column** – Select a cell within the column where you want to add a new column. Click the + icon to the left or right of the cell to insert a new column
- **Deleting a column** – Select a cell within the column you want to delete. Click the trash can icon to remove the entire column

### Distribute columns

This feature allows you to automatically adjust the width of each column in your table to ensure equal spacing. Simply click the "Distribute Columns" button to apply this formatting.

### Remove table

Click the **trash can icon** to remove the table from the text widget.

## Troubleshooting

### Why is there text missing in the Text Widget?

This issue might arise when content is copied from third-party tools and not pasted as plain text into the Happeo Text Widget. To resolve this, please follow these steps:

1. **Delete** the **existing** Text Widget
2. Add a **new** Text Widget
3. **Paste** the content as **plain text**

Furthermore, **browser plugins** designed for grammar and spell checking can sometimes cause content problems when adding it to the Text Widget. To address this, consider **disabling browser plugins** related explicitly to grammar and spell-checking before adding content to the widget.

### Clicking a "mailto" link takes me to my inbox instead of opening a new email to the linked address. Why?

"Mailto" links behave differently depending on your **browser settings**. By default, they **open your default email program** (often your **inbox**).

Here's how to configure **Chrome** to open a new draft for "mailto" links:

1. Click the **three dots** in the top right corner of **Chrome** and select " **Settings**"
2. Scroll down and click " **Privacy and security**"
3. Click " **Site settings**" and then " **Additional permissions**"
4. Expand " **Protocol handlers**" and choose " **Sites can ask to handle protocols**"
5. If " **mail.google.com**" is listed under " **Default behavior**," **remove** it by clicking the " **X**" next to it
6. Finally, open up your **Gmail email account** in a new tab on your computer
7. On the **right side** of the **URL's address bar**, there is an icon with two intertwined diamonds that will appear. Click on the icon to get a pop-up menu that asks, " **Allow mail.google.com to open all links?**"
8. Select " **Allow**" and then " **Done**"