Introduction to using widgets

Use widgets in your spreadsheet to improve the functionality and appearance of the wrap. This help page introduces you to widgets and their common features.

WrapCreator provides an extensive selection of graphical widgets that makes the wrap more appealing and easier to use. Use pre-formatted text fields, dropdown lists and calendars to improve the quality of the input data. Use Google maps and dynamically selected images to show your website visitors where you are, and what it looks like.

Widgets are inserted in the spreadsheet from the Widgets tab of the WrapCreator task pane in Excel. Select the cell where you want to insert the widget; then select the type of widget from the task pane. An options dialog appears, in which you can specify the detailed settings for the widget.

Most widgets are fully visible only in the web environment, even though you manage them in an Excel spreadsheet. To review the visual appearance of a wrap containing widgets, you must convert your spreadsheet for the web and verify the result in a web browser.

Widgets make the wrap look better

In general, spreadsheets have a strict user interface. Often, it’s just letters and numbers arranged in rows and columns. When spreadsheets like these are converted to web pages, they look dreadful (we really should call them dreadsheets).

WrapCreator re-uses any existing graphical elements already present in your spreadsheets. An input field containing true/false values automatically becomes a checkbox, and a dropdown list created with Data > Validation > List becomes a dropdown list also in the converted web page.

To help you create a more appealing user interface, we took a step further and created a toolbox of user interface widgets that makes it much easier to use your wrap:

  • Don’t write a date – pick one from a calendar.
  • Don’t list the things you need, tick the checkboxes next to the items you want.
  • Show an image of the wallpaper the customer is considering, in the selected color.
  • Use single- or multichoice menus for selection and adapt the choices to the roles each user has.
  • Use steppers or sliders to change a numeric value in real-time.
  • Use the Ratings widget to make it easy for your visitors to rate products or services.
  • Create an unlimited number of text fields in any size or shape you like.
  • Add a Google map to help people find your store.
  • Insert an e-mail button for those you want to contact you.

Insert widgets

The Widgets tab of the task pane contains all the widgets available in WrapCreator.

You can open the Widgets tab using the Insert Widget shortcut in the ribbon.

Screenshot of the Insert widget shortcut to the Widgets tab on the task pane

To insert a widget in a cell. select the cell where you want the widget to appear, then click on the widget’s icon on the Widgets tab in the task pane. A settings window appears to let you set the options for the widget you have selected, e.g.:

  • For dropdown lists, listboxes and radio buttons you enter the various different choices that the user can choose from.
  • For sliders and star ratings, you set the range of values, e.g. 0-100 for a slider or 1-5 stars for a rating.
  • For WrapLinks, select the wrap to link to, the unique key to use and what value to return from the designated wrap instance.

If you later need to modify these settings, just select the cell again and the settings page for the cell’s widget will appear in the task pane.

You can select multiple cells and insert the same type of widget in all selected cells with a single click. Regardless of how you insert widgets, you must still select them one by one to edit their properties.

Widget defaults

Many of the widgets have an initial value by default. You can usually override the default initial value by inserting a value in the cell of the spreadsheet in which you placed the widget, so if you type Hello into a cell that contains a Text widget, the widget will initially have that value, too.

When the form is converted to a wrap and opened in a web browser, most widgets are open for user input. The person that is using the form can override the initial values by changing the value of each widget.

We have tried to document the default value for every widget in their respective help pages. Here is a summary:

  • Text: empty, override by typing a value into the spreadsheet cell.
  • Slider: the minimum value for the slider, override by typing a value into the spreadsheet cell.
  • Stepper: the minimum value for the stepper, override by typing a value into the spreadsheet cell.
  • Rating: 0, override by typing a value into the spreadsheet cell.
  • Calendar: the current date, override by typing a date into the spreadsheet cell, or removing the default altogether.
  • Check box: FALSE (unticked), override by typing TRUE into the spreadsheet cell.
  • Radio buttons: the first choice in the list, override by moving one of the other choices to the top of the list.
  • Dropdown: the first choice in the list, override by moving one of the other choices to the top of the list.
  • Utility: the value returned by the formula in the cell.

Common settings


Some widgets can be set as Required, meaning that the user of a web form must do something with the widget before the form can be submitted. Here are some of the actions required by the user for the most common widgets, when they are set as Required:

  • Text: must enter text.
  • Radio buttons: must “press” one of the buttons.
  • Dropdown: must move the menu away from the option that is selected by default.


Developers use Hidden fields when they want a cell to be visible in the spreadsheet, but not in the converted web page. This allows them to provide information in the form without showing it in the form. As an example, if you use a cell to keep track of how long it took a user to fill in a form, you may want to hide this calculation. Even though a field is hidden, it’s contents are forwarded with the form when the form is submitted for processing.

Cell name

All input cells must have names. These names are used as column names when the data entered by the user into the wrap instance is saved in the database. You can name your cells in the widgets or give them cell names in Excel.

Make widgets look good

Merge adjacent cells

Widgets use the same row/column layout as the rest of the spreadsheet. Many of the widgets may require more space than the default row height and column width in Excel.

As an example, if you use a dropdown list, a listbox or radio buttons to select a city or state name from a list, you probably want the widget to be wide enough for the longest name in the list. If you don’t, WrapCreator must either wrap the longer names over more than one line (e.g. for radio buttons), or truncate the names after the allotted width (e.g. for dropdown lists).

If a widget is too big to fit within its cell’s height and width, the corresponding row and/or column may be widened automatically, depending on the web browser. This will probably harm the layout of your spreadsheet in an unpredictable way.

To make room for a large widget you can use Excel’s own Format Cells command to merge the cells in a cell area into one. First select all the adjacent cells you want to merge, then right-click somewhere in the area and select Format Cells…. On the Alignment tab, check the Merge cells option. This will create one big cell from all the cells you selected. Adjust the horizontal and vertical alignment if necessary.

In the example below, four columns and three rows, in total twelve cells, were merged for the Address multi-line text widget.

Screenshot of an address field created by merginc cells.

Move or copy a widget

Cell widgets can be moved using Ctrl+X  and then pasted into one or more other cells with Ctrl+V. You can also drag the cell and drop it in its new location.

Cell]/xlw] widgets can also be copied using Ctrl+C and then pasted into one or more other cells with Ctrl+V. This makes it easy to define a prototype widget, e.g. a text field, and afterward easily “clone” this widget and its settings to an unlimited number of cells.

You should assign a name to all the widgets in a
so that any received data is easier to decode. When you cut-and-paste a widget into a single cell you just move it to a different location under the same name, but a copied widget always needs its own unique name, and whenever you paste a widget into more than one cell you should go through them and give them their own names.

Regardless of how you insert widgets, you must still select them one by one to edit their properties. Copying widgets by selecting a cell and pressing Enter or using AutoFill (Fill Down/Fill Right) is not supported. 

Remove a widget

Most widgets have a Remove button. To remove a widget, select its cell and click Remove on the widget’s settings page.

Screenshot of the Remove button for a widget

If the task pane doesn’t open automatically, click on the Edit widget button in the WrapCreator ribbon.

If the cell still isn’t empty, it may contain a default value or a comment. Right-click on the cell and select Clear Contents from the menu to clear the cell.

Screenshot of the right-click menu for cells in Excel

Finally, since we use Data Validation for some widgets, you may also have to go to Excel’s Data tab, locate the Data Validation settings and click Clear All and then click OK.

Screenshot of the Data Validation settings with the Clear All button

Some widgets are function calls

Some widgets are just wizards that insert a function call into the cell, e.g. =wraplink(). To remove these widgets, you just need to remove the inserted function call.

  • Select the cell and edit the cell contents to remove the automatically inserted function call.
  • Select the cell and press the Del key on the keyboard.
  • Right-click on the cell and select Clear contents.

Remove enabling cells and holder cells

Some widgets use enabling cells to control their operation, e.g. like the WrapSignOff widget opens the signature field only when all prerequisite data is present in the wrap.  Other widgets use holder cells to facilitate testing within Excel, e.g. like the WrapLink widget returns the filter value to the holder cell when the wrap is online but uses a dummy value using testing.

Removing a widget does not remove its enabling or holder cells. You must first decide whether the cell has other purposes within the wrap. If it doesn’t add any value after the widget has been removed, you may delete the enabling cell and/or holder cell manually.

Known issues

Some widgets must be inserted one by one

Most cell widgets can be inserted into two or more cells with the same operation. The DropdownDynamic Dropdown and Radio widgets still need to be inserted one by one.

Image widgets cannot be copied

Widgets that use image placeholders like Link Image and Google Map may appear to support copying, but you are not copying the actual widget, only making a twin of its image placeholder. All these twin placeholders will always show identical content, since they are controlled by the same widget definition.

Learn more

Detailed descriptions of each widget