Common Options Tab for Custom Widgets

Step-by-step guide

1. In the CMS, navigate to Advanced Content → Custom Widgets.
   
   

2. Click Edit next to a widget that is in use (depicted by Used n time indicator in the In Use? column).
   
   
   
3. If we look at the DashboardBackOrders custom widget, then we see that the Include Common Options parameter is OFF.
   
   
   
   
4. You can check where that widget is used by clicking Options → Where is it used?
   
   
   
   
5. Click the Template directly from the Where is this widget used? pop-up, or navigate to the page location: Content → Pages & Templates → Accounts → Dashboard Page
   
   
6. Find the widget in the Page Template and click Edit.
   
   
   
   
7. You can see that there are only two tabs: General Options and Personalisation.
   
   
   
   
8. View the HTML code (Chrome: Inspect; Firefox: Inspect Element). Take note of the lines between the  highlighted line:<div class="content-box dashboard-module dashboard-back-orders"...> and the <header class="box-title"... "Back Orders" </header>.
   
   
   
   
9. Exit out of the widget and head back to the DashboardBackOrders custom widget by clicking Options and selecting <>View Source Code or navigating to Advanced Content → Custom Widgets.
   
   
   
   
10. Click Edit on the DashboardBackOrders widget, and this time, toggle Include 'Common Options' to ON.
    
    
11. Save your changes and return to Content → Pages & Templates → Accounts → Dashboard Page.
    
12. Edit the DashboardBackOrders widget and click on the Common Options tab.
    
    
    
    
13. You will see all the options available on the Common Options tab that is available on all non-Custom widgets.
    
    
14. View the HTML code (Chrome: Inspect; Firefox: Inspect Element).
    
    Note the addition of the '<div>' tag for the Dashboard Back Order Custom Widget surrounding the <div class="content-box dashboard-module dashboard-back-orders"...> and the <header class="box-title"... "Back Orders" </header> highlighted in the pre-enabled view.
    
    
    
    
15. To test it, edit the CUSTOM:DashboardBackOrders widget again and toggle Show On Mobile? to OFF.
    
    
    
    
16. Save your changes and notice the difference to the widget.
    
    

You can read more about the device icon display in the Widget Device Display Indication: Mobile, Tablet, and Desktop help page.

Additional Information

Related help

• Page:
  Custom Widgets
• Page:
  Custom Widget: Last Edited User
• Page:
  Edit custom widgets from the template page
• Page:
  Create a Custom Widget
• Page:
  Common Options Tab for Custom Widgets