š 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
Open the SOP page and click Edit. On an empty page, click New Element straight away.
Click New Element and choose New Text
Enter the Text Title
Enter the Text Description
Click New
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
In Editing, click where the video should go
Click Insert video in the toolbar. Your browser asks you to "Paste a video link (YouTube, Vimeo) or a direct video file URL:"
Paste the YouTube or Vimeo link and confirm
Click Save
The video plays right inside the text.
4. Add a Video Element
In Editing, click New Element and choose New Video
Enter the Video Title and, if you like, a Video Description
Click New. The element shows "Start by uploading the file" with Upload File and Add A Video Link.
Click Add A Video Link
Paste the whole link into the field (YouTube, Vimeo or a direct video URL)
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 |
