Widget Builder for Umbraco v6

Documentation Portal

This project is maintained by kgiszewski

Welcome to the Widget Builder Documentation Portal

Widget Builder is on-the-fly fieldset management and gives editors the flexibility to add what they need when they need it.

Comes with several native property types and is compatible with some 3rd-party property editors like DAMP.

If you need similar functionality in v7, please use Archetype.


This software is released under the MIT License.

You may use this package free of charge as there is no license check required in the current versions. However you may purchase a support license if you desire at the bottom of the page.

Clean Installation

Installing Widget Builder is done like any other package. Simply download and use the Developer Section->Install Local Package Wizard to get going. That's it.

Upgrading 1.x to 2.x

Make a backup of both your site code files AND the database. You'll be sorry if it all goes unwell.

This should be straight-forward, but somethings have been moved around and renamed so it may get slightly rocky (but probably not).

Download the package but DO NOT use package installer yet. Edit ~/App_Data/packages/installed/installedPackages.config with a text editor. Remove the XML 'package' element for Widget Builder only. This effectively tells your site to 'forget' about the fact you have Widget Builder installed. Delete from /bin - widget_builder.dll (and remove the reference if using VS). Install Widget Builder as a clean install as stated above.

Designing Your First Widget

Designing a Widget is easy. Follow these steps to get going:

Now that we have a Widget, you will need to affix the Widget to a doctype as you would any other data type.

Now that we have created a Widget and added it to a doctype. We need to create a piece of content based on that doctype. We will assume you know how to create content. Test your Widget from the newly created content.

Output Your Widget

You grab data from a Widget in your templates as you would any other data type. You can check your local ~/App_Data/umbraco.config to see how your data is being stored. It should be no surprise that Widget Builder stores its data as XML.

If using XSLT, you can navigate your $currentPage element and dig into your Widget as you see fit.

If using Razor, include the WidgetBuilder.Extensions namespace into your project. A list of methods can be found here.

Give Your Widget Personality

Another cool feature is injecting jQuery and/or CSS to your Widget to give it special behavior. You can inject these in two ways:

You can simply edit the built-in ~/umbraco/plugins/WidgetBuilder/custom.js (or css) files Or use different files by specifying the file names in the Developer Section-> Data Types -> My Widget prevalue page.

Import/Export Your Widget

Wouldn't it be great if you could simply copy/paste a widget to another widget either locally or to a different install altogether? Well you can.


Permissions in Widget Builder works as simply hiding some (or all) properties by User.

At this time you cannot do this by role. This information is stored in the ~/config/WidgetBuilder.config file.

How to get DAMP to work with Widget Builder

Make a backup of both your site code files AND the database. You'll be sorry if it all goes unwell.

If you use DAMP and want to use it with Widget Builder, you are in luck. Widget Builder presently works with DAMP 2.7. We can't control DAMP's development, but as long as you have that version of DAMP; we can rock and roll with it.

Known Issues

Widget Builder isn't perfect, here is a list of known issues:


This project is sunset but if you have a question, please send a tweet to @KevinGiszewski.

Formal support licensing (companies who need a bug fix, analysis, etc) can be purchased as well:

License Options