# Field Types

While using this template, you will come across multiple field types. This is a breakdown of each field type and how to use them correctly.

### Text

<figure><img src="/files/26UNACxw9s05TAvomcYZ" alt=""><figcaption><p>The article name field.</p></figcaption></figure>

1. Text box to enter copy
2. This button allows you to select a merge field from UbiQuity (e.g. a database field)&#x20;

***

### Link&#x20;

<figure><img src="/files/uRuncBbK3hNnmnQZGrzz" alt="A screenshot of the image link field."><figcaption><p>The image link field.</p></figcaption></figure>

1. Dropdown to select your link type, this can be URL, email or anchor (tel: coming soon)
2. Text box to enter said link
3. This button allows you to select from a Ubiquity link, this can be view online, form, survey or event link.&#x20;
4. This button links to the Media Manager where you can link to an image or other asset (e.g. .pdf or .doc) that you have stored in UbiQuity

***

### CK Editor

Here is where you will put your copy for the article. Here is the breakdown for all the toolbars attached to the CK Editor.

<table data-header-hidden><thead><tr><th width="475.10546875">Toolbars</th><th valign="top">Image</th></tr></thead><tbody><tr><td><p><strong>Text formatting</strong></p><ol><li>Make text bold</li><li>Make text italic</li><li>Change text colour - *see notes below</li><li>Remove styling</li><li>Ordered list</li><li>Bullet list</li></ol></td><td valign="top"><img src="https://resources.ubiquity.co.nz/Images/ckeditor-bar1.jpg" alt="Text formatting" data-size="original"></td></tr><tr><td>* When it comes to changing the text colour, you have the option to enter your brand colours via HEX code. Select the colour button, then click more colours then enter your hex code (be sure to include the ‘#’).</td><td valign="top"><img src="https://resources.ubiquity.co.nz/Images/ckeditor-colourpicker.jpg" alt="Colour picker" data-size="original"></td></tr><tr><td><p><strong>Text alignment</strong></p><ol><li>Left</li><li>Centre</li><li>Right</li><li>Justified</li></ol></td><td valign="top"><img src="https://resources.ubiquity.co.nz/Images/ckeditor-bar2.jpg" alt="Text alignment" data-size="original"></td></tr><tr><td><p><strong>Links</strong></p><ol><li>Link – you highlight and add a link to your copy.</li><li>Remove link</li><li>Anchor link – you can add an anchor point to your email and add the link to that anchor point somewhere else in the email.</li></ol></td><td valign="top"><img src="https://resources.ubiquity.co.nz/Images/ckeditor-bar3.jpg" alt="Links" data-size="original"></td></tr><tr><td><p><strong>Miscellaneous 1</strong></p><ol><li>Media Manager – while you can use this to insert an image, it is recommended to use an image-based layout (unless it’s going to sit in its own paragraph, e.g. a signature) or to link to a document or PDF.</li><li>Table – *see notes below</li><li>Insert special character</li><li>Paste copy as plain text - this is handy when pasting copy from sources that could have styling attached to the text (e.g. website or word). This option will remove any styling applied to the copy.</li><li>Paste copy from word, this will remove all styling that could be pulled across from word.</li></ol></td><td valign="top"><img src="https://resources.ubiquity.co.nz/Images/ckeditor-bar4.jpg" alt="Miscellaneous 1" data-size="original"></td></tr><tr><td><p>* When inserting a table, it is recommended that it’s a simple table (2-3 columns max) and for it to be resized to be 100% wide (this is to help it rescale on mobile)</p><p>Click on the advanced tab and change the 500 to 100% in the style text field.</p></td><td valign="top"><img src="https://resources.ubiquity.co.nz/Images/ckeditor-table-options.jpg" alt="Table options" data-size="original"></td></tr><tr><td><p><strong>Paragraph</strong></p><p>Here you can change whether you are using a paragraph (normal) or headings. You can set the default sizes for paragraph and Heading 1-3 in the template options.</p></td><td valign="top"><img src="https://resources.ubiquity.co.nz/Images/ckeditor-bar5.png" alt="Paragraph" data-size="original"></td></tr><tr><td><p><strong>Font</strong></p><p>This a list of email safe fonts (meaning that readers of the email should have these fonts installed on their device). It is not recommended you use these fonts and to set your font in the template options.</p></td><td valign="top"><img src="https://resources.ubiquity.co.nz/Images/ckeditor-bar6.jpg" alt="Font" data-size="original"></td></tr><tr><td><p><strong>Size</strong></p><p>Here you can change the font size. You should set your main font sizes in the template options and only use this to resize a one-off paragraph (e.g. terms and conditions).</p></td><td valign="top"><img src="https://resources.ubiquity.co.nz/Images/ckeditor-bar7.jpg" alt="Size" data-size="original"></td></tr><tr><td><p><strong>Mergeable's</strong></p><ol><li>Insert a merge field (e.g. database field)</li><li>Insert a UbiQuity link</li><li>Share to social. You can share this article or email to Facebook, X or LinkedIn.</li></ol></td><td valign="top"><img src="https://resources.ubiquity.co.nz/Images/ckeditor-bar8.jpg" alt="Mergables" data-size="original"></td></tr><tr><td><p><strong>Miscellaneous 2</strong></p><ol><li>Spellcheck</li><li>Expand – this will expand the CK editor to full screen</li><li>Source – this will show you the HTML code the CK editor creates (you can also write your own HTML/CSS in here</li></ol></td><td valign="top"><img src="https://resources.ubiquity.co.nz/Images/ckeditor-bar9.jpg" alt="Miscellaneous 2" data-size="original"></td></tr></tbody></table>

***

### Colour picker

<figure><img src="/files/vnVZLu7FatAHYQM4lQOU" alt="A screenshot of the background colour option."><figcaption><p>The background colour option.</p></figcaption></figure>

1. Colour swatch - this also opens a colourpicker window\* to select a colour&#x20;
2. Hexcode: you can manually type in your hexcode if you have it.&#x20;

\*Colour picker window – where you can select a colour directly, enter RGB or the hexcode. Hit ‘Set’ to save.

<figure><img src="/files/55C3NnLMQr7tlvqvkirt" alt="A screenshot of the colour picker."><figcaption><p>The colour picker option.</p></figcaption></figure>

***

### Image

If there currently isn’t an image you can hit the + icon and add the image, this will take you to the Media Manager.

<figure><img src="/files/6E6zxRFpZCWampBcQrQ0" alt="A screenshot of the add image option."><figcaption><p>The add image option.</p></figcaption></figure>

Once an image has been selected you will see the options/details below

<figure><img src="/files/fVjO8YDn6cPI6PpsFrcx" alt="A screenshot of the options that show once an image has been added."><figcaption><p>The options that show once an image has been added.</p></figcaption></figure>

1. Image thumbnail
2. Alt text (it is best practice to add this so your content is accessible to all users ie. vision impaired)&#x20;
3. Image width
4. Image height
5. Remove image
6. Change image
7. Aspect ratio locked (this keeps the image in proportion).&#x20;

The max image width will change depending on the spacing selected. If the image is too wide an error will display at the top of the dialogue box.&#x20;

<figure><img src="/files/IEwMOfXXsu21jkYFAje5" alt="A screenshot of the error message that shows if your image is too wide."><figcaption><p>The error message that shows if your image is too wide.</p></figcaption></figure>

### Radio select

<figure><img src="/files/GVxOy0Kmb7qrMI8ruA8w" alt="A screenshot of the radio select option."><figcaption><p>The radio select option.</p></figcaption></figure>

Single select to set options/settings for the template or article.

***

### Checkbox select

<figure><img src="/files/LmJeq1IAZnoqC5Q1ZjqK" alt="A screenshot of the checkbox select option."><figcaption><p>The checkbox select option.</p></figcaption></figure>

Like the radio select, checkbox select is used to show/hide other article options or set settings in the article block.

***

### Slider&#x20;

<figure><img src="/files/X6FWvL8XVjEBdbraYdaE" alt="A screenshot showing an example of a slider."><figcaption><p>An example of a slider.</p></figcaption></figure>

Allows you to set a numeric value setting, e.g. spacing or font size. Move the dot left/right to change the value.

***

### Elements Block

<figure><img src="/files/4shG6KdYXjKcZzbpo1uq" alt="A screenshot of an elements block."><figcaption><p>An elements block.</p></figcaption></figure>

An elements block is a field that houses multiple fields, that allows you to have multiple of the same element (e.g. CTA button) in one article. You can add, copy and delete an element item using the buttons on the right.

If this field is not required, just delete each element using the buttons.


---

# 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.ubiquity.co.nz/documentation/channels/email/email-templates/field-types.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.
