Page Content Sections - Custom HTML Section

Use the Custom HTML Section when you need to place raw HTML on a page and one of the standard section types will not do what you need.

What this section is for

This section is best reserved for special cases.

Common examples include:

• third-party embed codes
• custom layout blocks that are not possible with standard sections
• iframe content such as maps or external widgets
• small advanced snippets maintained by someone comfortable reviewing HTML

Helpful detail:

• The website outputs this field directly, so this section is much less forgiving than the regular content sections.

Fields in the Custom HTML Section

Section Title

Use Section Title to help your team identify the section while editing the page.

Helpful detail:

• This title is internal only. It is not shown on the website.

Custom HTML

Use Custom HTML to enter the markup you want rendered on the page.

Helpful details:

• This is a plain text area, not a visual editor.
• The section renders the saved HTML directly.
• If the markup is broken, the page layout can break too.
• This section is usually best for people who are comfortable checking HTML carefully.

Active

Use Active to control whether this section is included when the page is rendered.

Helpful detail:

• If Active is turned off, the section stays in the page editor but does not appear on the website.

Important behavior to know

• This section does not add its own headline field, intro field, or built-in layout wrapper.
• The page simply outputs the saved HTML when the section is active.
• Page access still follows the page's own permission settings.
• If a safer standard section can do the job, that is usually the better choice.

When this section is a good fit

This section may be appropriate when you need something like:

• an official embed code from another service
• a custom Bootstrap layout block
• a special widget that cannot be built with the normal page sections

This section is usually not the best first choice for:

• normal paragraphs and links
• simple headings and formatted text
• standard forms
• content that another page section already supports well

How to add a Custom HTML Section to a page

1. Open the page you want to edit.
2. Go to the Page Content area.
3. Click Add new section.
4. Choose Custom HTML Section.
5. Enter a Section Title for internal reference.
6. Paste or type the content into Custom HTML.
7. Make sure Active is turned on.
8. Save the page.
9. Review the page on the website right away.

Practical safety tips

• Use this section only when another built-in section truly will not work.
• Keep the HTML as small and focused as possible.
• Review copied embed code before saving it.
• Avoid adding code from sources you do not trust.
• If the content needs regular editing by non-technical staff, consider a simpler section type instead.
• Check the page on both desktop and mobile after saving.

If the section is not behaving as expected

Check these items first:

• the page was saved after your edits
• the section's Active toggle is turned on
• tags are closed correctly
• pasted embed code is complete
• the issue is not coming from the external service providing the embed or widget

Related topics

• Page Content Sections - Simple Text Section - Use this for most normal text content.
• Page Content Sections - Form Section - Use this instead of hand-building a normal form in custom markup.
• Pages - Learn how pages and page sections are managed.