Homarr
Workshop

Community Workshop

The Community Workshop hosts community Custom Widgets and dashboard CSS.

Experimental

Workshop content is community-maintained. Review its source and permissions before installation.

Content flow

AuthorBuild shareable content
Custom Widget JSONCustom CSS
publish
WorkshopSource, screenshots, and revision
inspect
Review + importValidate source and requested access
local
Your HomarrConfigure and place on a board
Widget → local URLs + secretsCSS → board custom CSS
Workshop stores the shareable definition. Instance-specific URLs and credentials stay local.

Workshop also exposes the Homarr Assistant provider. Its model-routing and quota path is separate from Custom Widget and CSS submissions.

Install content

Browse Widgets or CSS, search by title, description, or author, and sort the listings. Use Hide outdated to exclude submissions marked outdated. The result count shows how many listings match; Reset filters restores the full list.

  • Install a Custom Widget from Management → Custom Widgets → Import from Workshop.
  • Import dashboard CSS from Board settings → Custom CSS → Import from Workshop.

To install from the website, open a listing and review its source. Its Install in Homarr section sits beside the download and copy controls:

  • Select Download widget JSON, then open Management → Custom Widgets → Import and select the file.
  • For CSS, select Copy CSS, paste it into Board settings → Custom CSS, and save.

Custom Widget credentials are configured in your Homarr instance and are not part of the Workshop submission.

Publish content

Publish a saved Custom Widget from its action menu under Management → Custom Widgets. Custom CSS and manual submissions can be published from the Workshop website.

Sign in to the Workshop and open Yours to update or delete submissions and review reports. Signed-in users can vote, comment, and report content; Workshop moderators can remove content. Workshop moderation is separate from administration of a Homarr instance.

See the Workshop operator guide to host Workshop or Workshop development to run it from the repository.

On this page