Skip to main content

Add custom JavaScript

If you have some JavaScript you need to run when your Owncast web page loads, you can add it in the admin under Configuration > General > Custom Scripting.

The Custom Scripting tab of the General settings page, showing the JavaScript editor

Some examples of reasons you might need this:

  • Adding privacy-respecting analytics.
  • Initializing a payment processor you have embedded on your page.
  • Use JavaScript to manipulate the interface.
Plugin scripts require Owncast v0.3.0

Starting in Owncast 0.3.0, the /customjavascript endpoint serves your code followed by the scripts of every enabled plugin, so your code and plugin scripts share the same page context.

Owncat warns you

Double check your JavaScript. Any incorrect syntax or errors that you insert into the page may create errors and stop the page from loading or functionality from working.


Improve this page

See something missing or incorrect? Edit this page and improve the documentation for everyone.

Contributors to this documentation

Related Documents