A Custom Code widget embeds a web page or an HTML snippet on a dashboard. Think of a window in the page that shows something built elsewhere: a form, a report, a badge. You paste the code or the address, and the page must allow itself to be embedded.
Here is the test: do you have an embed code from another tool? If yes, paste it here. For a page by its address, the Webpage widget does the same job. To run your own JavaScript with the SmartSuite SDK, use the Scripting widget.
Example: the Vendor risk overview shows the company's trust badge, pasted as the badge provider's HTML snippet.
The trust badge embedded on the Vendor risk overview.
Plan Availability | All plan types. |
Permissions | Solution Managers and members with Full Access add and change widgets on a public dashboard; the owner does on a private one. |
Platform | Web |
Related Reading |
Adding a Custom Code widget
Set the View | Edit switch in the upper right to Edit.
Select + Add Widget in the toolbar. The Add New Widget sidebar opens on the right with a Search Widget box and thirteen collapsible categories. Page Display is open to start.
Open Utilities and select the Custom Code card. Its info icon reads "Embed custom HTML code directly in your dashboard."
The Custom Code modal opens. The preview sits on the left and the settings on the right, on one tab, General. Paste the code or the address, then select Add Widget at the foot.
The widget lands on the dashboard. Drag it by its handle to move it.
The General tab
The General tab is the only tab. It holds the Heading section and the Settings section with two choices, Embed HTML and Embed URL.
Heading
Title is the widget's name, prefilled with "Custom Code". Description is a switch, off to start; on, it adds a text box and the choice As A Tooltip or Below The Title.
Embed HTML
One of two choices, and the one chosen to start. A text area with the placeholder "Paste HTML code" and the helper "Paste your embed HTML in the textbox above". Until you paste, the preview reads "Set a value for preview". Then it renders the code.
Embed URL
The other choice. Its tooltip reads "Specify the URL of the website you want to embed." A box with the placeholder "Paste URL" takes the address. An address that does not start with https:// shows the red message "The URL needs to start with https://". A site that refuses framing shows "This URL cannot be embed" and the preview stays empty. Add Widget stays enabled either way.
Tip: Try the address here before you build around it. If the preview stays empty with "This URL cannot be embed", the site's owner blocks framing, and no widget will show it.
The General tab with Embed URL chosen and the message This URL cannot be embed under the box.
Permissions
Solution Managers and members with Full Access add and change widgets on a public dashboard. The owner does so on a private one. Every member who can open the dashboard sees the embed. See Dashboard Settings.
Using the widget
In View mode the embedded content shows inside the widget's body, and a viewer uses it as they would in a browser tab.
Note: A site that blocks framing shows nothing, and no setting in the widget changes that. The site's owner decides.
A Filter widget and a Record Selector do not change a Custom Code widget. It holds no records.
Editing a Custom Code widget
In Edit mode, hover over the widget and select Edit in the strip that appears above it. The modal reopens; change the code or the address, then select Save Changes at the foot. Cancel after a change asks "Are you sure you want to exit without saving the changes you made?", with Exit Without Saving and Save Changes. The strip's More Options menu holds Minimize, Highlight Color, Duplicate Widget, Delete Widget and Collapsed by Default; see Managing Widgets.
Frequently asked questions
Custom Code or Webpage: which one?
Custom Code or Webpage: which one?
Custom Code takes an HTML snippet or an address. For an embed code from another tool, use Custom Code.
Why is my embed blank?
Why is my embed blank?
The page does not allow embedding. The modal shows "This URL cannot be embed" for such an address. Check with the page's owner or use a link instead.
Can I run JavaScript in it?
Can I run JavaScript in it?
For a script that reads or writes SmartSuite data, use the Scripting widget, which runs in a sandbox with the SmartSuite SDK.
Last verified 30 Oct 2026.


