Adding Text Features | Vellum Help

Adding Text Features

Vellum’s Text Features are created using the Add Text Feature menu at the top of the Text Editor. Use it to apply specialized formatting to the contents of your book:

Menu for Text Features

A Note on Style

The appearance of some Text Features can depend on the Style selection you’ve made. In these cases, examples will include an image of Vellum’s Text Editor and one of Vellum’s Preview.


Use a subhead to title a section of a chapter. Select the text you’d like to use as your subhead and use the Add Text Feature menu to convert it into a subhead:

Text Editor Preview

Note: the Style demonstrated above automatically transforms the subhead into uppercase. Typically, you should leave your text in mixed case and let Vellum handle these transformations.

Ornamental Break

An Ornamental Break is a type of scene break, and can be used to indicate a change of location, time, or narrator. It is often stronger than a break indicated solely by whitespace.

To create an Ornamental Break, simply select where you’d like to insert the break, and use the Add Text Feature menu. It will appear in the Text Editor as a cluster of three asterisks:

Text Editor Preview

In your book, the ornamental break’s appearance will depend on how you’ve configured the Ornamental Break style.


Include an Inline Image anywhere within your text by using the Text Feature menu or by dragging an image into your document.

Text Editor Preview

See the Inline Image documentation for more details about configuration.

Alignment Block

Use an Alignment Block to explicitly declare the alignment for a block of text, such as a section that should be centered:

You can change the block’s alignment using the Gear menu that is available when text within the block is selected:

A left-aligned block will not be indented, as seen in this use as an introduction to a chapter:

As demonstrated in the example above, text within an alignment block is never formatted as the first paragraph in a chapter. Instead, the text that follows the block will be formatted as the first paragraph (in this case, with a drop cap).


The Inset option adds margin to the left and right sides of the Alignment Block:

As shown above, an inset, flush-left Alignment Block is one way to format a text message conversation.


Use a List for a collection of items:

Lists are bulleted by default: each item in the list is automatically preceded by a round bullet (•). Using the Gear menu shown to the right of your list, you can change it to be numbered instead:

In a numbered list, each item is automatically preceded by an incrementing number:

Block Quotation

Use a Block Quotation to specially format a quotation, either because you wish to highlight it or because it is too long to include within a standard paragraph. Select the text to use as the content, and then use the Add Text Feature menu to create a Block Quotation:

Text Editor Preview


To include the source of the quotation, use the Gear menu to the right of the quotation and select Add Attribution:

A dedicated text field will appear to enter the attribution:

Text Editor Preview

Note that, with the demonstrated Style, the attribution is automatically preceded with a long (”em”) dash and is set in small caps.


The content of a Block Quotation rarely includes quotation marks, especially if it includes an attribution.

Keep Lines on Same Page

You can control where page breaks are allowed to occur using the Keep Lines on Same Page menu item, also accessible from the gear menu.

By default Keep Lines on Same Page is off and page breaks are allowed to occur anywhere in the Block Quote. When it’s on, if a paragraph can't fit entirely on one page, then it will be moved to the next.

Note: The Kindle, Kobo, and Google Play reading applications do not honor this setting. Vellum’s Preview takes this into account, which means that you won't see a change in the Preview if you’ve chosen one of those devices.


If you include lines of poetry or songs within your book, you can use the Verse feature to format them appropriately. Unlike in a Block Quotation, each line is set flush left within the Verse.

As with a Block Quotation, you can use the gear menu to add an Attribution to your Verse:

Text Editor Preview

You can also choose whether to Keep Lines on Same Page. When you’ve selected that option, if a stanza doesn’t fit on a page, then it will be moved to the next.

To link to websites from within your book, use the Web Link feature. Select the text you'd like to use as the label for the link, and then use the Add Text Feature menu to turn it into a link. A popover will appear that will let you paste or type in a URL:

Once a Web Link is created, you can always click on it to bring up the popover again. If you have Smart Links turned on (via the main menu's Edit ▸ Substitutions ▸ Smart Links item, which is enabled by default), then Vellum will automatically convert what you type into a Web Link, if appropriate.

Note: to link to a book in a store, you should use the Store Link text feature (below). And if you’d like to link to your page on a social media site like Facebook or Twitter, you can use an About the Author element, which also provides icons for those links.

To link to a book on a supported online store, use a Store Link:

The Store Link popover allows you to set the book’s title and per-store identifiers. The easiest way to enter these identifiers is to go to the book's page on each store, copy the URL, and paste it into the appropriate text field. Vellum will extract the book identifier for you.

For a more in-depth discussion of Store Links and the preferences that affect their behavior, see our Store Links help page.