Compose tips

Text Formats

Basic HTML

  • Allowed HTML tags: <br> <p> <h2> <h3> <h4> <h5> <h6> <strong> <em> <a href> <ul> <ol start> <li> <table> <tr> <td rowspan colspan> <th rowspan colspan> <thead> <tbody> <tfoot> <caption> <img src alt height width data-entity-uuid data-entity-type data-caption data-align> <drupal-media data-entity-type data-entity-uuid alt data-caption data-align> <drupal-url data-embed-button data-embed-url data-entity-label data-url-provider>

  • You can embed URLs. Additional properties can be added to the URL tag like data-caption and data-align if supported. Examples:

    • <drupal-url data-embed-url="https://www.youtube.com/watch?v=xxXXxxXxxxX" data-url-provider="YouTube" />

  • You can convert plain URLs to <drupal-url> HTML elements. Those elements are later converted to embeds using "Display embedded URLs" text filter.

  • You can align images, videos, blockquotes and so on to the left, right or center. Examples:

    • Align an image to the left: <img src="" data-align="left" />
    • Align an image to the center: <img src="" data-align="center" />
    • Align an image to the right: <img src="" data-align="right" />
    • … and you can apply this to other elements as well: <video src="" data-align="center" />

  • You can caption images, videos, blockquotes, and so on. Examples:

    • <img src="" data-caption="This is a caption" />
    • <video src="" data-caption="The Drupal Dance" />
    • <blockquote data-caption="Dries Buytaert">Drupal is awesome!</blockquote>
    • <code data-caption="Hello world in JavaScript.">alert("Hello world!");</code>
  • Only images hosted on this site may be used in <img> tags.

  • You can embed media items:

    • Choose which media item to embed: <drupal-media data-entity-uuid="07bf3a2e-1941-4a44-9b02-2d1d7a41ec0e" />
    • Optionally also choose a view mode: data-view-mode="tiny_embed", otherwise the default view mode is used.
    • The data-entity-type="media" attribute is required for consistency.

Restricted HTML

  • Allowed HTML tags: <br> <p> <h2> <h3> <h4> <h5> <h6> <strong> <em> <a href> <ul> <ol start> <li>

    This site allows HTML content. While learning all of HTML may feel intimidating, learning how to use a very small number of the most basic HTML "tags" is very easy. This table provides examples for each tag that is enabled on this site.

    For more information see the HTML Living Standard or use your favorite search engine to find other sites that explain HTML.

    Tag Description You Type You Get
    By default line break tags are automatically added, so use this tag to add additional ones. Use of this tag is different because it is not used with an open/close pair like all the others. Use the extra " /" inside the tag to maintain XHTML 1.0 compatibility Text with <br />line break Text with
    line break
    By default paragraph tags are automatically added, so use this tag to add additional ones. <p>Paragraph one.</p> <p>Paragraph two.</p>

    Paragraph one.

    Paragraph two.
    Heading <h2>Subtitle</h2>

    Subtitle
    Heading <h3>Subtitle three</h3>

    Subtitle three
    Heading <h4>Subtitle four</h4>

    Subtitle four
    Heading <h5>Subtitle five</h5>
    Subtitle five
    Heading <h6>Subtitle six</h6>
    Subtitle six
    Strong <strong>Strong</strong> Strong
    Emphasized <em>Emphasized</em> Emphasized
    Anchors are used to make links to other pages. <a href="https://settlementatwork.org">SettlementAtWork</a> SettlementAtWork
    Unordered list - use the <li> to begin each list item <ul> <li>First item</li> <li>Second item</li> </ul>
    • First item
    • Second item
    Ordered list - use the <li> to begin each list item <ol> <li>First item</li> <li>Second item</li> </ol>
    1. First item
    2. Second item
    No help provided for tag li.

    Most unusual characters can be directly entered without any problems.

    If you do encounter problems, try using HTML character entities. A common example looks like &amp; for an ampersand & character. For a full list of entities see HTML's entities page. Some of the available characters include:

    Character Description You Type You Get
    Ampersand &amp; &
    Greater than &gt; >
    Less than &lt; <
    Quotation mark &quot; "

  • You can align images, videos, blockquotes and so on to the left, right or center. Examples:

    • Align an image to the left: <img src="" data-align="left" />
    • Align an image to the center: <img src="" data-align="center" />
    • Align an image to the right: <img src="" data-align="right" />
    • … and you can apply this to other elements as well: <video src="" data-align="center" />
  • Lines and paragraphs are automatically recognized. The <br /> line break, <p> paragraph and </p> close paragraph tags are inserted automatically. If paragraphs are not recognized simply add a couple of blank lines.
  • Web page addresses and email addresses turn into links automatically.

Plain text

  • No HTML tags allowed.
  • Lines and paragraphs are automatically recognized. The <br /> line break, <p> paragraph and </p> close paragraph tags are inserted automatically. If paragraphs are not recognized simply add a couple of blank lines.
  • Web page addresses and email addresses turn into links automatically.