====== Block ======

A block is a designed HTML element of your email, for example a story, a header, a footer, etc. Blocks are stored in a [[templates|template's]] [[editor#block-library|Block Library]], and, when in the [[editor|Editor's]] [[editor#layout-mode|Layout Mode]], can be dropped into the [[section|Sections]] of your email to achieve different layouts without requiring a new template.

The editable areas of a block are called [[slot|slots]]; these are the areas that you can click on in the Editor's [[editor#content-mode|Content Mode]] to change the text or images. Blocks can only appear inside [[section|sections]].

In HTML terms, a block is nearly always an HTML table.

===== Example block code =====

The following code should be nested inside opening and closing section markers. For completeness, we have added a slot marker too.

<code html>
<!--BlockStart Name="Text Story" Width="600" LibraryOnly="true"-->
<table width="600">
    <tr>
        <td>
            <!--SlotStart-->
            Here's some content...
            <!--SlotFinish-->
        </td>
    </tr>
</table>
<!--BlockFinish-->
</code>

===== Block Properties =====

^ Property ^ Required ^ Values ^ Description ^    
| Name     | No | Text | Displayed in the Block Library to help users identify the block. |
| Width    | No | Number | If used, this block will only be shown by default if its Width (declared in pixels with no units) is equal to or less than than a section's Width property. Users can still use this block if they adjust the Block Library's filtering options. This property is useful to prevent users from using blocks that are too wide for sections and could break a template's layout. |
| LibraryOnly | No | True/False | Blocks which have this property to set to true will be added to the template's block library but not shown in the default layout. This is useful when you create a template with many blocks to save users needing to delete unneeded ones each time they create a new email. |