Skip to main content

Custom Code on Website Builder

Written by Audry

Custom Code allows you to extend and customize your website beyond standard website builder features. You can add your own JavaScript, CSS, HTML, tracking scripts, marketing pixels, third-party integrations, and widgets directly through Site Settings.

This gives you full flexibility to modify how your website looks and behaves, while still keeping control over when changes go live.

What Custom Code is used for

Custom Code is designed for advanced customization needs that are not available through the standard builder.

Common use cases include:

  • Adding analytics or tracking tools

  • Installing marketing pixels (e.g. campaign tracking)

  • Embedding third-party widgets or tools

  • Applying custom styling or layout changes

  • Extending website behavior with JavaScript

  • Integrating external services or scripts

Who can use Custom Code

Only users with the correct permissions can access and manage Custom Code.

Can manage Custom Code:

  • Super Admin

  • Website Admin

Cannot manage Custom Code:

  • Users without website management permissions

  • Users without access to Site Settings

How Custom Code works

Custom Code follows a Draft → Publish workflow, similar to other website content.

1. Add or edit Custom Code

  • Go to Site Settings

  • Open Custom Code

  • Add or edit your code

  • Click Save

Your changes are saved as a Draft, not yet visible on the live website.

2. Save changes as Draft

When you save:

  • Your code is stored as a draft version

  • It does not affect the live website

  • You can continue editing before publishing

This allows you to safely prepare updates without impacting visitors.

3. Publish to make it live

To apply your changes:

  • Publish your website

Once published:

  • The latest saved draft becomes active

  • Custom Code is applied to the live website

  • Visitors will see the updated behavior immediately

Where Custom Code applies

You can control where your Custom Code runs on your website.

Supported options may include:

  • Entire website

  • Specific page(s)

  • Specific section or location

This allows you to apply code globally or target only specific areas.

Draft vs Live behavior

Draft

  • Not visible to website visitors

  • Stored safely in Site Settings

  • Can be edited multiple times before publishing

Live (Published)

  • Visible to all website visitors

  • Reflects the latest published version

  • Only updates after website is published

Important limitations

Custom Code is powerful, but it works without system validation.

This means:

  • The platform does not check if your code is correct

  • Invalid or incomplete code can still be saved and published

  • The system does not test whether scripts work as expected

As a result, issues such as the following may occur:

  • Scripts not running

  • Styling not applying correctly

  • Third-party tools not loading

  • Widgets not appearing

  • Unexpected website behavior

Common issues and what to check

1. Custom Code is not visible on the live website

Possible reason: The website was not published after saving changes.

What to check:

  • Confirm Custom Code was saved

  • Confirm the website was published after the change

2. Custom Code is not working on the live website

Possible reason: The code may contain errors or be incompatible.

What to check:

  • Confirm the code exists in Custom Code settings

  • Confirm the website was published

  • Review whether the script is valid and complete

3. Custom Code does not appear in Builder preview

Expected behavior: Custom Code does not run inside the Builder preview.

What to check:

  • Always test changes on the live published website

4. Multiple admins updating Custom Code

If multiple admins edit the same site:

  • The latest saved draft will be the version that gets published

  • Older drafts will be overwritten

What’s not included

This feature does not include:

  • Code validation or syntax checking

  • Debugging assistance

  • Compatibility checks with third-party tools

  • Preview rendering inside the website builder

  • Automatic error detection

Notes

  • Saving Custom Code alone does not update the live website

  • Publishing is required for changes to take effect

  • Only Super Admin and Website Admin can manage Custom Code

  • Support teams do not troubleshoot or debug custom scripts

  • External integrations (pixels, widgets, scripts) are fully managed by the user

  • Browser behavior determines whether custom code executes successfully

Did this answer your question?