Skip to main content

Rich Text and Video

Covers adding a Text element to an SOP page, the editor toolbar, embedding YouTube or Vimeo videos in text, adding a Video element with a video link, and what to do if a Text element shows two quote marks.

Written by Support

šŸ“‹ Overview

Most processes start as a few paragraphs: what the job is, why it matters, and the steps in order. When that text sits in an email or a Word file on someone's laptop, nobody can find it the day it's needed. A two-minute video of a foreman showing the right way to do it is worth even more, and it usually lives on someone's phone.

The Text and Video elements put both on your SOP pages in Company Operations. A Text element holds formatted writing with headings, lists, images and embedded YouTube or Vimeo videos. A Video element puts one video on the page, from a link or an uploaded file.

Use them together. Write the steps in a Text element, and put the walk-through video right under it.


šŸ” Understanding Rich Text and Video

⚔ What It Does

The Text and Video elements allow you and your team to:

  • Write formatted process steps -- with headings, bulleted and numbered lists, task lists and separators

  • Add images -- and align them left, center or right

  • Embed a YouTube or Vimeo video inside text -- next to the steps it explains

  • Format text -- bold, italic, underline, strikethrough and links

  • Add a stand-alone video -- from a YouTube, Vimeo or direct video link

šŸ“… When to Use It

Rich Text and Video are most valuable when you want to:

  • Explain a process in words before the checklist or form that goes with it

  • Show a technique on video instead of describing it

  • Add photos of what good work looks like

  • Keep training videos in the same place as the process they teach


šŸ“ Step-by-Step Instructions

1. Add a Text Element

  1. Open the SOP page and click Edit. On an empty page, click New Element straight away.

  2. Click New Element and choose New Text

  3. Enter the Text Title

  4. Enter the Text Description

  5. Click New

  6. Click Save

Note: Currently, if you leave Text Description empty, the element shows two quote marks ("") in place of text after the page reloads. Fill in the description when you create the element. If you see the quotes, click Edit, delete them, type your content and click Save.


2. Format Your Text

In Editing, click into the text to use the toolbar:

  • Heading -- choose Heading 1, Heading 2, Heading 3 or Body

  • Bulleted list, Numbered list and Task list

  • Separator -- a line between sections

  • Insert image -- opens your computer's file picker so you can choose an image. Then select the image and use Align image left, center or right. The align buttons stay greyed out until an image is selected.

  • More formatting -- Bold, Italic, Underline, Strikethrough, Link... and Clear formatting

Click Save when you're done.


3. Embed a YouTube or Vimeo Video in Text

  1. In Editing, click where the video should go

  2. Click Insert video in the toolbar. Your browser asks you to "Paste a video link (YouTube, Vimeo) or a direct video file URL:"

  3. Paste the YouTube or Vimeo link and confirm

  4. Click Save

The video plays right inside the text.


4. Add a Video Element

  1. In Editing, click New Element and choose New Video

  2. Enter the Video Title and, if you like, a Video Description

  3. Click New. The element shows "Start by uploading the file" with Upload File and Add A Video Link.

  4. Click Add A Video Link

  5. Paste the whole link into the field (YouTube, Vimeo or a direct video URL)

  6. Click Save

A YouTube link becomes a player on the page. The element also has an Upload File button.

Note: Currently, typing a link into Add A Video Link saves it after the first character and leaves a player that won't play. Copy the link and paste it in one go. If it goes wrong, click Discard Changes and add the video again.


⭐ Best Practices

  • Paste links, don't type them -- the video link field saves as soon as you start typing, so a typed link breaks.

  • Always fill in the Text Description -- an empty one shows "" on the page after a reload, until you fix it.

  • Use headings for each step -- a long block of text is skipped. Headings let people find their step.

  • Keep videos short -- one task per video is easier to follow on a job site than one long recording.

  • Put the video next to the steps it shows -- people watch it while they read, not in a separate library.

  • Use a task list for quick reminders, a Checklist element for records -- task list ticks aren't submitted or tracked.


ā“ Common Questions

Q: Should I use Insert video in a Text element or a Video element?

A: Use Insert video when the video belongs inside your written steps. Use a Video element when the video is the main content, so it gets its own title and place on the page.


Q: Which video links work?

A: Both the Video element's link field and Insert video in a Text element take YouTube, Vimeo or a direct video file URL. Paste the full link.


Q: My video element shows a player that won't play. What happened?

A: The link was probably typed, and it saved after the first character. Click Discard Changes, or delete the element, and add the video again by pasting the whole link.


Q: Why does my Text element show ""?

A: Currently, a Text element created with an empty Text Description shows two quote marks once the page reloads. Click Edit, delete the quotes, add your content and click Save.


Q: Can I add a quote block or code block?

A: Currently, the toolbar doesn't have them. Use Bold, a heading or a Separator to set text apart.


Q: Is a task list in text the same as a Checklist element?

A: No. A task list is formatting inside the text. A Checklist element is submitted and keeps a history. See SOP Checklists.


āš ļø Common Mistakes to Avoid

āŒ Don't

āœ… Do

Type a video link into Add A Video Link

Paste the whole link in one go

Create a Text element with no description

Fill in Text Description when you create it

Leave Editing without clicking Save

Save, then check the page in view mode

Use a text task list for work you need to track

Add a Checklist element and have people submit it

Write every step in one long paragraph

Use headings and numbered lists

Did this answer your question?