SugarCRM SupportProduct GuidesSugar Versions11.011.0 EnterpriseSugar Enterprise 11.0 Application GuideUser InterfaceAccessibility

Accessibility

Overview

Sugar enables users to quickly perform certain tasks using keyboard shortcuts to increase productivity and accessibility. Keyboard shortcuts can be used to navigate around the list view and record view layouts for Sidecar modules, allowing users quickly select records, inline edit records, preview records, etc. There are also global shortcuts available to perform tasks such as toggling the Quick Create menu, entering the Global Search field, etc. Users can also customize the key combinations which activate each shortcut.

This documentation will cover the various keyboard shortcuts available as well as how to navigate around Sugar using your keyboard. For more information regarding accessibility for Sugar, please refer to the Accessibility information. 

Shortcut Keys

There are various shortcut keys available to easily perform actions in Sugar using your keyboard. You can use the shortcut keys to favorite a record, delete records, etc. in the Sidecar module's (e.g. Accounts, Contacts) list view and record view layouts. In addition, the global shortcuts can be utilized throughout the user interface to perform actions such as opening the Quick Create menu, accessing the Global Search field, etc.

You can access the Keyboard Shortcuts help page by either hitting the Shift and / key or clicking the Shortcuts link in Sugar's footer. The help page will display a table with the various shortcut keys available to use along with a description of the actions they perform. The shortcuts displayed are contextual based on what you are currently viewing in Sugar. For example, if you are viewing the Mass Update panel in the Accounts list view, then the Keyboard Shortcuts page will display shortcuts that specifically apply to this panel. Simply hit "Esc" on your keyboard or click the Close button if you wish to exit the page. You can also customize the key combinations for each shortcut by clicking the Gear button.
Accessibility KeyboardShortcuts

Global Shortcut Keys

The global shortcut keys can be used to perform the following actions in Sugar's user interface:

Windows/Linux Key Mac Key Function
c c Toggle the Quick Create menu
esc, ctrl+alt+l esc, cmd+alt+l Exit the Global Search field
s, ctrl+alt+0 s, cmd+alt+0 Access the Global Search field
t t Toggle the Right Hand Side drawer in list view and record view
ctrl+shift+space cmd+shift+space Toggle the Sweet Spot bar

List View Shortcut Keys

The list view shortcut keys can be used to perform the following actions in the module's list view layout:

Windows/Linux Key Mac Key Function
+ + Add field rows in the Mass Update or Filter panel
- - Remove field rows in the Mass Update or Filter panel
a a Create new record
ctrl+a cmd+a Select all records displayed on current set of list view results
ctrl+s, ctrl+alt+a cmd+s, cmd+alt+a Save record
d d Delete record or custom filter in list view
e e Edit selected record in list view
esc, ctrl+alt+l esc, cmd+alt+l Exit out of certain elements (e.g. inline edit) in the list view
f+a f+a Mark selected record as a favorite
Note: Hit "f+a" again to remove the record as a favorite.
f+c, ctrl+alt+8 f+c, cmd+alt+8 Create a new list view filter
f+e  f+e  Edit custom list view filter
f+i, ctrl+alt+9 f+i, cmd+alt+9 Place cursor in list view search box
f+m f+m Open the list view filter menu
f+o f+o Mark selected record to follow or unfollow
h h Scroll list to the left
j j Select the next record on the list view
k k Select the previous record on the list view
l l Scroll list to the right to view additional fields in the list view
m m Open the mass actions menu
Note: Menu opens once at least one record is selected.
o o Open the selected record's (e.g. ABC Company) record view
p p Preview the selected record
r r

Clear filter values

t t Toggle the Right Hand Side drawer
x x Mark the checkbox to the left of each selected record in list view

Record View Shortcut Keys

The record view shortcut keys can be used to perform the following actions in the module's record view layout:

Windows/Linux Key Mac Key Function
ctrl+s, ctrl+alt+a cmd+s, cmd+alt+a Save the record
d, ctrl+alt+d d, cmd+alt+d Delete the record
e, ctrl+alt+i e, cmd+alt+i Edit the record
esc, ctrl+alt+l esc, cmd+alt+l Exit out of certain elements (e.g. edit view) in the record view
f+a f+a Mark record as a favorite
Note: Hit "f+a" again to remove the record as a favorite.
f+o f+o

Mark record to follow or unfollow

h h Open the previous record
l l Open the next record
m Open the record's Actions menu
shift+c, ctrl+alt+u  shift+c, cmd+alt+u  Copy the current record 
t t Toggle the Right Hand Side drawer

Customizing Shortcut Keys

You can customize the key combinations which activate each shortcut. This is especially useful if you use the default key combinations for other functions such as typing special characters.

Use the following steps to customize the shortcuts' key combinations:

  1. Access the Keyboard Shortcuts page by clicking the Shortcuts link in Sugar's footer.
  2. Click the Gear button on the top right of the page.
    Shortcuts gear button
  3. Update the Key value you want to change in the Contextual Shortcuts table.
    Accessibility ContextualShortcuts¡
    Note: Depending on your operating system, the "mod" which appears in key combinations will be the Control key (for Windows and Linux computers) or the Command key (for Mac). Use "mod" to indicate the use of these keys.
  4. Click "Save" to preserve your changes.

If you ever wish to revert all of your custom key combinations, click the "Restore default" option in the actions menu.
Accessibility RestoreDefault

Since the Keyboard Shortcuts page shows contextually appropriate shortcuts, repeat these steps on various Sugar views in order to access all of the shortcuts.

Tabbing in Sugar

Using the Tab key (Alt+Tab for Safari browser) on your keyboard enables you to easily navigate through Sugar's navigation bar which spans across the top of the screen. Please note that the default tab order is from left-to-right. As you hit the Tab key, each option (e.g. home, module tabs, global search, notifications, etc.) on the navigation bar will be highlighted in blue, and you can press "Enter" if you wish to access the module's list view, actions menu, notification's page, etc. For example, if you press "Enter" on the triangle in the Accounts module tab, the corresponding actions menu will open and you can use your Up and Down arrow on your keyboard to select an option (e.g. Create Account, View Accounts, etc.). If you hit "Tab" again while the list view actions menu is open, you will navigate to the next option (e.g. Contacts) on the navigation bar and the current actions menu will close.
Accessibility Tab NavigationBar

In addition, you can continue to tab outside of the navigation bar to highlight and access certain elements (e.g. Create button, Search box, Intelligence Pane, etc.) of the home page, list view, record view, etc. For example, if you continue tabbing after you get to the end of the navigation bar while viewing the Accounts list view, the tab will move onto the various elements on the page highlighting buttons, actions menu, account names, etc. You can simply hit "Enter" if you wish to perform a specific action (e.g. create a record, open the actions menu, etc.) on the list view. The tab will go through all of the currently displayed records on the list view then move onto the intelligence pane and footer before going back to the navigation bar again. Please note that each link (e.g. Mobile, Shortcuts) in Sugar's footer will be highlighted as you tab from left-to-right. Simply hit "Enter" on your keyboard if you wish to access any of the links on the footer.
Accessibility Footer 

As you tab through Sugar's navigation bar, you will access the Global Search bar where you can perform a search across the entire Sugar database. Once you enter in a search term, you can use the Up and Down arrow keys on your keyboard to navigate through the quick search results and hit the Tab key to close the Quick Search Results list and return to the search bar. In addition, you can also tab through the View All Results page to highlight and access certain elements (e.g. Search box, Intelligence Pane, Preview button, etc.) of the page as well. For more information on navigating through global search using your keyboard, please refer to the Search documentation. 

Last modified: 2021-09-30 12:59:38