Creating and editing custom widgets

Shared widgets appear on the Custom Widgets tab in the Widgets tool and they are distinguishable by a Shared Widget icon. They are available to add to your course homepage, but you cannot modify their content. You can only modify the content for custom widgets that are created within your course offering.

  1. Create a custom widget
  2. Edit a custom widget
  3. Add HTML custom code
  4. Add release conditions to a custom widget
  5. Replace strings

Create a custom widget

  1. On the My Home or Course Home page, click Edit Course, then click Widgets.
  2. Click Create Widget.
  3. Enter a Name and Description for the widget.
  4. If you want to share your custom widget with other org units, click Add an Org Unit (only applicable at the organization level).
  5. Click Save and Close.

Edit a custom widget

  1. On the My Home page or a course homepage, click Edit Course, then click Widgets.
  2. Click the Edit Edit icon beside the widget you want to edit.
  3. Make your changes and click Save and Close.


The Properties tab allows you to define or change the widget name, description, and sharing settings (only available at the organization level).


The Content tab allows you to add your own custom HTML (with the exception of ASP) code and incorporate your organization or course’s specific colors, and logos when creating widgets.

Use the default content window of the HTML Editor to add content to your widget and click the Edit HTML Source icon in the bottom left corner to add HTML custom code.

Add HTML custom code

  1. In the Content tab on the Edit Widget page, click the Edit HTML Source icon in the bottom left corner of the HTML Editor to open the HTML Source Editor.
  2. Add your HTML custom code. For example, the following HTML custom code can be used to create a YouTube solar car video feed using a “solar car” tag:

    <iframe height="350" width="265" frameBorder="0" src=" car" marginHeight="0" marginWidth="0" name="videos_list" id="videos_list"></iframe>

  3. Click Update.
  4. Click Customize Widget Style to apply different styling options to the widget. See Editing widget display.

    Note  To help you meet visual accessibility standards, there is a built-in WCAG (Web Content Accessibility Guideline) checker on the Widget Settings page. Be aware that if you choose a shade that does not meet these guidelines (for example, the contrast between the text color and the background color is too low), the check mark by WCAG AA will be replaced by a warning or error icon to alert you to possible accessibility issues.

  5. Click Save and Close.

Release conditions

The Release Conditions tab allows you to define a set of criteria that must be fulfilled (e.g. a user must be enrolled in the current org unit as a specific role). If a user doesn't meet the set release conditions they won’t see this widget on their homepage. For example, you could create a widget with links visible only to instructors.

The conditions most likely to apply to widgets are as follows:

Replace strings

Replace strings allow you to use dynamic fields in HTML content that display applicable information based on the user and org unit. They are available when you create widgets and other HTML content using the HTML Editor.

Current Org Unit {OrgUnitId}, {OrgUnitName}, {OrgUnitCode}, {OrgUnitTypeID}

Organization  {OrgId}, {OrgName}

Current user {UserId}, {UserName}, {OrgDefinedId}, {FirstName}, {LastName}, {Email}

User’s role in current org unit  {RoleId}, {RoleCode}

See also


Desire2Learn Help | About Learning Environment