Resources are very similar to blogs and can include a table of contents (TOC) on the right side of the page to help readers navigate to different sections. When enabled, the TOC is generated from the headings used in the content and stays visible while the reader scrolls.
The TOC is enabled by default for new resources, but can be disabled if desired. Blogs also support the same optional TOC functionality.
An example Resource page with a TOC is shown below:
New! Gradual has just unveiled a new blog and resource editor that allows for more customization and better handling of PDFs, images, videos and more.
New icon styles and options
Better handling of alignment and resizing for images, videos, and PDFs
Captions and link generation for images, videos, and PDFs elements
Local PDF upload support
Ability to apply code formatting to code blocks
This updated blog & resource editor will be available to all communities and dashboards soon, but will be rolled out in phases.
Customization of the 'Resource' name
Some communities don't use the name 'Resources' for their written content and prefer terms like 'Docs' or 'Slides', etc. Gradual now allows you to customize what written content is referred to in the main menu and throughout your community.
Sign into the dashboard and navigate to the Content menu, and to Resources.
In the upper right hand side select the button that reads 'Name'.
Enter the name you’d like to appear in the main menu and throughout the platform when referencing content pieces made in Resources. Names can be up to 25 characters, and a character counter shows how many characters have been entered.
Resource & Blog Editor Versions
Legacy Resource Editor
The majority of the community dashboards use the legacy or default resource editor that allows for rich text content, images, video embeds and more. The steps described below to build and edit a resource are using the legacy editor.
This blog editor looks like this:
A new blog & resource editor was released in Q2 of 2025 that allows for more customization and better handling of PDFs, images, videos, and more. This updated editor will be available to all communities and dashboards soon, but will be rolled out in phases.
Learn more about this new blog & resource editor here.
The new editor includes new icons and features, and looks like this:
Creating a Resource
Sign in to your dashboard.
Select the Content tab from the main menu, and then Resources from within that menu.
Click on +New Resource on the top right.
Fill in the necessary information, including Title and Sub Title.
The Sub Title populates under the Title on the Resource page and should be a one-liner description.
The Summary populates under the Title on the Content page and while not necessary, provides another opportunity for a one-liner description.
Sub Title and Summary can be the same text.
Fill the Content description with your text. The Table of Contents (TOC) setting is enabled by default for new resources. If enabled, format your section and subsection titles using heading styles to automatically generate the TOC. You can disable the TOC if you don't want it displayed.
You can embed links, tables, images and even iframes in the content block.
Upload a Cover Image and select, or add a category. If you’d like to include tag(s) to the post, and gate or limit access by spaces, make those selections.
Save your work by clicking Submit in the upper right corner. On the Resource overview page in the dashboard, the right-hand sidebar shows the Resource URL and View Count.
💡 Pro Tip: Link to a static content page like your FAQs or Product Roadmap with a custom content page using Resources and Custom URLs.
Structuring a table of contents
The Table of Contents (TOC) setting is enabled by default for new resources, but can be disabled at any time. When enabled, section heading styles determine how the TOC is structured. The TOC is automatically generated from the heading styles used in your content.
In your Content editor, there are four types of section heading styles: Heading 1, Heading 2, Heading 3, and Heading 4.
A rule of thumb is that a bigger section heading and its immediately smaller section heading (for example, Heading 1 and Heading 2, or Heading 2 and Heading 3) will each create an entry in the TOC, a section and a subsection. In the example TOC below, the section "2022" may be the Heading 3 element while the subsections "August" and "September" may be the Heading 4 elements.
Once you decide on the section heading style that is going to be a section and the one that is going to be a subsection, you should stick to that formatting. For example, if you decide that Heading 3 is for a section title and Heading 4 is for a subsection title, do not use Heading 1 elsewhere. If you do so, the Heading 1 element will form an entry in the TOC, while the Heading 3 elements and Heading 4 elements won't. This is because a bigger section heading, along with its immediately smaller section heading, is always prioritized to form a TOC entry.