Select text in a SmartDoc field and a formatting toolbar appears. Use it for headings, bold, colors, lists and links, and type / for blocks such as tables, callouts and a table of contents.
Example: a Policies table in a compliance program. Policy Statement is a SmartDoc field that holds the Information Security Policy. The policy owner formats it so reviewers can scan it: one heading per section, bold on every "must", and a callout for the rule auditors ask about most.
Plan Availability | All plan types. |
Permissions | Any member who can edit the record can format its SmartDoc. |
Platform | Web |
Related Reading |
The formatting toolbar
Open the record and find the SmartDoc field. In this example it is Policy Statement.
Select the text you want to format. The toolbar appears above it.
Pick an option. The change shows at once.
The formatting toolbar over selected text in the Policy Statement field, with the text style list open at Heading 2.
The toolbar holds these options, from left to right:
Text style: Normal Text, Small Text, Heading 1 to Heading 6 and Code Snippet.
Format: bold, italic, underline and strikethrough.
Alignment: left (the default), center or right.
Text color and highlight: 10 text colors and 9 highlight colors.
Code, link and quote.
Lists: bulleted list, numbered list and checklist.
Tip: In the policy, bold only the obligations, such as "Tier 1 vendors must have a SOC 2 report on file." Reviewers then find every rule by scanning.
Headings that fold
A heading is a section header. Select the arrow beside a heading to collapse it. Everything under it hides, up to the next heading of the same level. Smaller headings inside it hide too.
For the Information Security Policy, use Heading 1 for the six sections and Heading 2 inside them. A long policy then folds down to its outline.
Lists
Bulleted list: type - or \* and a space, or use the bulleted list button.
Numbered list: type 1. and a space. Any number starts the count at that number.
Checklist: type the first item, select it and use the checklist button.
Links
A web address typed or pasted into the document becomes a link. To link a SmartSuite record, type / and select Link to Record, or type # and pick the record. See SmartDoc Feature: Links for links to saved views and for editing a link.
Blocks from the slash command
Type / at the start of a line, or after a space, to open the block menu. These blocks lay out a document:
Insert Table: a table you can format cell by cell. See SmartDoc Feature: Tables.
Insert Callout: a colored block with an icon. See SmartDoc Feature: Callouts.
Table of contents: an outline built from your headings. See SmartDoc Feature: Table of Contents.
Insert Code Block: code with syntax highlighting. Three backticks at the start of a line do the same.
Insert Divider Line: a line between sections.
Insert Image, Insert Video and Insert Attachment: media and files. You can also drag a file onto the document.
Note: An image dropped onto the document shows as an image. To show it as a file name readers download, insert it with Insert Attachment instead.
Frequently asked questions
How many text colors can I use?
How many text colors can I use?
The text color list has 10 colors and the highlight list has 9.
How do I make a heading collapse?
How do I make a heading collapse?
Format the line as a heading from the text style list, or type # and a space. Select the arrow beside the heading to fold the section under it.
Can I add a table to a SmartDoc?
Can I add a table to a SmartDoc?
Yes. Type / and select Insert Table. The table has its own menu for rows, columns and colors.
Does text pasted from Word keep its formatting?
Does text pasted from Word keep its formatting?
Yes. Text pasted from Word or Google Docs keeps its formatting.
Where are the keyboard shortcuts?
Where are the keyboard shortcuts?
SmartDoc Hot Keys lists every shortcut and every Markdown command.
Need more help? Ask the SmartSuite Community, where builders, administrators and the SmartSuite team answer questions about building on SmartSuite. For your account, billing or data, select the chat button in the lower-right corner of SmartSuite to reach support.
Last verified 1 Nov 2026.

