Use the Embeddable Task Step in OnRamp
Updated
The Embeddable step lets you pull the outside world directly into an OnRamp task — videos, calendars, presentations, forms, live SaaS tools — so customers and teammates never have to jump between apps to complete a step.
Steps
1. Open the Task Builder
Go to the Playbook or Project where you want to add the step.
Create a new task or edit an existing one, then select + to add a step.
2. Select the Embeddable Step
From the step type list, choose Embeddable.
3. Choose Your Embed Method
URL Embed — loads the full webpage directly. Good for live SaaS dashboards.
HTML Embed — uses the service’s dedicated iframe snippet. Cleaner and purpose-built for embedding (use this when available).
4. Add Your Content
Select URL or HTML, then enter the address in Source URL or paste the snippet into Source HTML. If a site doesn't allow its page to be embedded, you see the error
The URL is not embeddable.Optional: Enter Width and Height in pixels to control the viewing window. Width defaults to the full width of the space, and height starts at 600.
Check the preview, which shows under the fields as soon as you enter a valid URL or HTML. The preview isn't available while merge fields are used.
Select Save Changes.
5. Preview and Test
Use Preview Mode in the project portal to check how the embed appears.
Adjust dimensions until the content looks clean with minimal scroll bars.
In the Customer Portal
Customers see the embedded content directly inside their OnRamp portal once the subtask is ready to answer. While the subtask is open, they can interact with the embedded content, such as selecting slides, playing videos or booking meetings. After the subtask is completed, the portal shows The step was answered and it's completed.
Popular Use Cases
Presentations — embed a Google Slides deck for customers to review
Video walkthroughs — YouTube, Vimeo, Loom, or Wistia
Meeting scheduling — a Calendly calendar so customers can pick a time
Forms and spreadsheets — collect data through a live Google Form or Sheet
App access — link customers to a third-party tool without leaving OnRamp
Tips & Troubleshooting
Switching between URL and HTML clears what you entered in the source field.
Adjust Width and Height (in pixels) to avoid scroll bars. In the customer portal, HTML embeds grow taller to fit their content, up to 4000 px. HubSpot meeting links show at least 756 px tall.
Most embeds count as answered as soon as the content loads. A HubSpot meetings scheduler is the exception: if the portal didn't detect a booking, saving opens a Did you book a meeting? dialog with Go back and I booked it. Scheduler subtasks also can't be checked off without an answer. The portal tells customers to select Complete Task on the last subtask, or Save & Continue otherwise.
While the subtask is open, customers can select Open in a new tab for a URL embed that uses a regular web (http or https) link. If any embed, URL or HTML, hasn't loaded after about 10 seconds, the portal also shows a warning telling customers to open it in a new tab.