SugarCRM SupportDocumentationSugar Versions7.117.11 UltimateSugar Ultimate 7.11 Application GuideUser Interface
This release is only available for Sugar cloud customers.

User Interface

Overview

The user interface includes all of the visible elements users see and interact with while using Sugar including the headers, fields, subpanels, dashboards, etc. Knowing how to properly navigate around the application along with what the various layouts, options, and action items do in Sugar will be critical in managing your data in the system. This documentation covers the basics of Sugar's user interface as well as how to perform common tasks or operations in the application.

Sidecar Modules

This documentation will cover the user interface that was introduced in Sugar 7 called "Sidecar". Below is a list of modules which use the Sidecar user interface. Other modules continue to use the Legacy user interface which is described in detail in the User Interface (Legacy) documentation.

  • Accounts
  • Bugs
  • Calls
  • Cases
  • Contacts
  • Contracts
  • Emails
  • Forecasts
  • Home
  • Knowledge Base
  • Leads
  • Meetings
  • Notes
  • Opportunities
  • Processes
  • Quoted Line Items
  • Quotes
  • Reports
  • Revenue Line Items
  • Tags
  • Targets
  • Target Lists
  • Tasks

Note: Custom modules created in Module Builder will utilize the Sidecar user interface. Custom modules installed to an instance prior to Sugar 7 that were not created in Module Builder will use the Legacy user interface upon upgrade to 7.x.

All pages within Sugar display a navigation bar spanning across the top of the screen. The navigation bar allows you to access the various modules (e.g. Accounts, Contacts, etc.), access your Home page, perform a global search, etc. You can configure the navigation bar via your user preferences to select which modules you want to display as well as their order. For more information, please refer to the Layout Options section of the Getting Started documentation.

The default navigation bar consists of the following options from left to right:
711-navbar

Navigation Bar Item Description
Home Click the Sugar Cube icon on the upper left to access your Home page dashboards as well as your Activity Stream.
Module Tabs Both stock and custom modules can be displayed in the navigation bar. Click the module name to open its list view or click the triangle to the right of each module name to display the Actions, Recently Viewed, and Favorites menus.
Global Search Enter keywords into the global search bar to search for records across all Sugar modules.
Notifications View system notifications (if any) by clicking the notification box. The number shown indicates the count of unread notifications.
User Menu Click the user profile image to open the user menu which allows access to your profile, the Employees module, etc.
Quick Create Click the Plus icon to open the Quick Create menu which allows you to create records from anywhere in Sugar.

Home

You can access your Home page from anywhere in Sugar by clicking the Cube icon at the top left of every page. Sugar's home page houses full-page dashboards and your instance-wide activity stream. Additionally, you can manage your dashboards and visit recent records from the Home page actions menu. For more information, please refer to the Home documentation.
711-home-menu2

Module Tabs

Module tabs are located to the right of the Sugar cube icon on the navigation bar at the top of any Sugar screen. To access a specific module's list view, simply click the module's name. You may also click the triangle to the right of the name to display the Actions, Recently Viewed, and Favorites menus. The Actions menu allows you to perform important actions within the module. The Recently Viewed menu displays the list of records you last viewed in the module. The Favorites menu displays the list of records you most recently marked as favorites in the module.
Accounts ModuleTabMenu

The number of displayed module tabs depends on your screen resolution as well as the size of your browser window. When your available modules do not fit within the navigation bar's width, clicking the overflow icon (three stacked dots) to the right of the displayed modules allows you to select and navigate to the list view of the additional modules.
711-overflow-menu

If you do not see a particular module tab in Sugar, please check the following:

  • The module may be marked as hidden in your user preferences which will prevent the module tab from being displayed. Navigate to your user menu (upper right of Sugar), click "Profile", click the Advanced tab, and check the Layout Options section. If you see the module in the Hide Modules list, simply move it to the Display Modules list and save. For more information on hiding and displaying modules, please refer to the Layout Options section of the Getting Started documentation.
  • The administrator may have disabled the module for your entire Sugar instance. Reach out to your Sugar administrator to have the module displayed. For more information on displaying and hiding modules throughout Sugar, please refer to the Developer Tools documentation.

Global search allows users to search for information across their entire Sugar database as opposed to restricting search within a specific module. The Global Search bar displays on the upper right of any Sugar page and utilizes full-text search to search throughout most fields and modules for an enhanced search experience.
711-global-searchbar

Clicking on the search bar will expand it across Sugar's navigation bar. To perform a search, type the search phrase into the search box, and the pop-up results will begin appearing once you enter at least one character. Click "View all results" at the bottom of the pop-up results to see and filter additional matches. To minimize the search bar, simply click anywhere outside of the search bar. For more information on using Global Search, please refer to the Global Search section of the Search documentation.

Once expanded, you will be able to access the Modules dropdown by clicking the down arrow on the far left of the search box. This allows you to restrict results to particular modules (e.g. Accounts, Contacts, etc.). For more information on configuring your global search, please refer to the Search documentation. Administrators can also enable or disable modules as well as control additional elements of global search via Admin > Search and Admin > Studio. For more information on these configurations, please refer to the Field Options section of the Studio documentation as well as the Search section of the System documentation.

Notifications

Sugar notifications relay key messages, warnings, and alerts which are relevant to the current user. The Notifications indicator is available to all users and is located on the upper right of the screen next to global search. The number displayed in the notifications box indicates the number of messages with a status of "Unread". A "0" will appear if there are no unread notifications. Clicking the number will reveal a dropdown displaying your most recent notifications. From the open Notifications dropdown, click "View Notifications" in order to see all notifications in a list view. You can also navigate directly to a single notification's record view by clicking the subject (e.g. Missing SMTP Server settings) in the dropdown.
711-notify

The favicon (SugarCRM cube icon) in your browser tab will also display the count of unread notifications. Please note that the favicon notification count only appears in the tab while logged into Sugar. When the notification count changes, the favicon's count will update within 5 minutes of the change or upon reloading the browser.

Note: The favicon count can only be viewed when accessing Sugar using the Chrome, Firefox, or Opera browser.
711-notify-badges

Notifications Severity Levels

Each notification will have one of four severity levels:

  • Alert (Red) : Indicates something is critically wrong with your Sugar instance and needs the attention of your Administrator immediately
  • Warning (Yellow) : Indicates something in your Sugar instance needs your attention or the attention of your Sugar Administrator to remedy
  • Information (Blue) : Standard notification including reminders of an upcoming meeting, call, or task
    • Note: In order for a notification to appear, a newly created activity must be scheduled to begin at least one hour later than the time it was created.
  • Success (Green) : Indicates the successful completion of an action or configuration change

Notifications List View

The Notifications list view displays all notification records meeting the current search criteria. For more information about searching for the desired records, please refer to the List View Search section. The following information and options are available from the list view:

  • Preview : You can preview a notification's details by clicking the Preview button to the right of the notification. Close the preview by clicking the "x" at top right.
  • Refresh : Update the current view to retrieve the latest list view results.
  • Severity : The color-coded severity of each notification is displayed in the Severity column.
  • Status : The Status field indicates whether or not a notification has been viewed. A notification will be automatically marked as "Read" if the record view is opened or the notification is previewed. You can also manually toggle the Status field by clicking its current value.
  • Record view : To open a notification in record view, simply click the notification's subject.

711-preview-pane

Notifications Record View

The Notifications record view displays the details of a specific notification. The following information and options are available from record view:

  • Links : If a notification requires actions within the Sugar application, a link may appear in the Description field. Clicking the link will take you to the related record or the area where action is needed.
  • Severity : The color-coded severity of each notification is displayed.
  • Status : The Status field indicates whether or not a notification has been viewed. A notification will be automatically marked as "Read" if the record view is opened or the notification is previewed. Users may also manually toggle the Status field by clicking its current value.

711-notify-rv

User Menu

Your profile icon appears in the upper right of Sugar; clicking it displays the user menu where you can access your profile, the Employees page, and view important version information about your instance. To upload a photo for your profile image, please refer to the Getting Started documentation.
711-profile-menu

The user menu allows you to perform the following operations:

Menu Item Description
Profile View your user profile, change your password, and personalize various aspects of Sugar.

Employees

Navigate to the Employees module to search and view employee records. Users with administrative privileges can also create and edit employees in the system.
Note: Every user is listed as an employee; however, every employee may not be a user in Sugar.
Admin Navigate to the Admin page to configure and customize various aspects of your Sugar instance.
Note: This option is only available if you are an administrator user or have or developer-type role access.
About Navigate to the About page to view your instance's current Sugar edition, version, and build, as well as credits and source code references.
Log Out Log out of your current user session. You will be directed back to the Sugar login page for your instance.

Quick Create

The Quick Create menu allows you to easily create new records from anywhere in Sugar. Simply click the Plus button on the upper right of any Sugar page to access the menu. Please note that a maximum of ten modules may be enabled to display in the Quick Create menu. Administrators can configure which modules are enabled and the order in which they appear via Admin > Configure Navigation Bar Quick Create. For more information, please refer to the Developer Tools documentation.
711-quickcreate

Clicking on an item in the Quick Create menu will open the record view form for the specific module. When using quick create while viewing an existing record where a relationship exists between the two modules, Sugar automatically relates the new record to the one being viewed. For example, if you are viewing an account, ABC Company, and create a new contact via quick create, the Account Name field in the new contact will automatically populate with "ABC Company", thus creating the link between the two records.

All required fields will indicate "Required" in the field and must be completed prior to saving. Once the necessary information is entered, click "Save". If you do not wish to create the record, simply click the Cancel button. Please note that administrators have the ability to configure the record view layout via Admin > Studio. For more information on configuring record view layouts, please refer to the Studio documentation.

Note: Because the Quick Create drawer overlays the page from where it is launched, using the browser's back button will appear to send you back two pages instead of to the previous view. To return to the previous view, use the Cancel button instead.

Sugar's footer displays the SugarCRM logo, Mobile link, Shortcuts link, Feedback link, Help link, as well as links to enabled third-party integrations. Users can click these links to go back to their Home page, access the help pane, etc.
711-footer

The following links are available in Sugar's footer:

  • Logo : Click the logo on the bottom left of Sugar to return to your home page. Administrators can replace the SugarCRM logo with a custom logo via Admin > System Settings. For more information, please refer to the System Settings documentation.
  • Widgets : Links for any installed third-party integrations will appear to the right of the SugarCRM logo.
  • Mobile : When viewing Sugar via a touch-screen device, the Mobile link will appear allowing you to view Sugar's mobile site.
  • Shortcuts : Access the Keyboard Shortcuts help page to view the various shortcut keys available to use along with a description of the actions they perform. For more information regarding the Keyboard Shortcuts help page, please refer to the Accessibility documentation
  • Feedback : The Feedback window will pop up allowing you to communicate your overall satisfaction with Sugar. Once you have entered the necessary information, simply click "Send" to submit your feedback
  • Help : Access the help pane via the Home page or a Sidecar module's list view/record view (e.g. Accounts) by clicking the Help link. The top of the help pane provides a brief introduction to the current module and includes a link to the module's corresponding documentation. In addition, the following learning resource and Sugar 7 tour links are available in the help pane:
    • Sugar University : Opens the Sugar University page where you can access information regarding online and live training, the Sugar certification program, etc. 
    • Community Forums : Opens the Community Forums page where you can collaborate with other users, Sugar partners, and Sugar employees to ask questions as well as participate in active discussions, help solve problems, etc.
    • Documentation & Support : Opens the SugarCRM Support page where you can access the case portal, documentation, knowledge base articles, etc.
    • Tour : Launches a quick tour to show key features of the user interface for the home page and Sidecar module page (e.g. Accounts) you are currently viewing. For more information regarding the Sugar 7 tour, please refer to the Tour section of the Getting Started documentation.

711-helpwindow

Creating Records

There are various methods for creating records in Sugar including basic creation, quick create, duplication, and import. The same record view layout opens when creating records by any of these methods and includes all of the relevant fields. Please note that administrators can configure the Record View layouts to tailor them to your organization's needs via Admin > Studio. For more information on configuring layouts, please refer to the Studio documentation.

Basic Record Creation

The most common method of record creation is via the individual module itself using the Create button in the list view or the Create {Module} option in the module tab. This opens the record view layout in edit mode which allows you to enter all of the desired information.

The following steps cover creating an account via the Accounts module as an example:

  1. Click the triangle in the Accounts module tab to open the actions menu and select "Create Account". You can also click the Create button on the upper right of the Accounts list view.
    • From Accounts list view:
      711-lv-create
    • From Accounts module tab:
      711-tab-create
  2. Enter appropriate values for the fields in the record view layout. All required fields will indicate "Required" in the field and must be completed prior to saving.
  3. Once the necessary information is entered, click "Save".

Creating via Quick Create

The Quick Create menu allows you to easily create new records from anywhere in Sugar. Simply click the quick-create button on the upper right of any Sugar page to access the menu.

Note: Administrators have the ability to enable or disable a module in the Quick Create menu. Also, some modules are not available to be enabled. For more information, please refer to the Developer Tools documentation.

The following steps cover creating an account via Quick Create as an example:

  1. Open the Quick Create menu on the upper right of any Sugar page and select "Create Account".
    711-qc-record
  2. Enter appropriate values in the fields in the record view form. All required fields will indicate "Required" in the field and must be completed prior to saving.
  3. Once the necessary information is entered, click "Save".

Creating via Subpanels

On record views, beneath a record's fields, subpanels appear which contain related records from various modules. You can create a related record as well as link an existing record directly from the subpanel.

Note: Administrators have the ability to disable a module's subpanels for the entire instance via Admin > Display Modules and Subpanels. For more information, please refer to the Developer Tools documentation.

The following steps cover creating a contact via a Contacts subpanel as an example:

  1. Click the Plus button on any Contacts subpanel on a related module's record view.
    711-subpanel-create
  2. Enter appropriate values in the fields in the record view form. All required fields will indicate "Required" in the field and must be completed prior to saving.
  3. Once the necessary information is entered, click "Save".

Creating via Duplication

You can also create a new record by duplicating an existing record. The Copy option is useful if the record you are creating has similar information to an existing record. Please note that existing subpanel relationships for the original record will not carry over to the duplicate.

The following steps cover creating an account by duplicating an existing account as an example:

  1. Navigate to an account's record view.
  2. Click the Actions menu and select "Copy".
    711-copy-create
  3. The displayed record view is pre-populated with the original account's values. Update the necessary fields, then click "Save".

Importing Records

The import function allows you to push multiple records of a single module into Sugar using a .cvs file instead of creating them one-by-one. For more information, please refer to the Import documentation.

The following steps cover importing accounts as an example:

  1. Click the the triangle to access the Actions menu in the Accounts module tab and select "Import Accounts".
    711-import
  2. In Step 1, select the import file and choose "Create new records only". Click "Next".
  3. In Step 2, confirm the import file properties. Click "Next".
  4. In Step 3, confirm the field mappings for the import. Click "Next".
  5. In Step 5, view the import results.
    • The Created Records tab will show all of the new account records.
    • The Duplicates tab will show any records in the file that were identified as duplicates of existing records and thus not imported.
    • The Errors tab will show records that were not imported due to errors detected during import.

Viewing Records

Sugar records can be viewed from a variety of location including via the module's list view, record view, Recently Viewed menu, dashlets, and reports. Please note that you will only be able to see records as allowed by your team membership, user access type, and assigned roles. For more information on teams and roles, please refer to the Team Management and Role Management documentation.

Viewing via List View

Each module's list view displays all of the module's records that meet the current search criteria. To access the list view, simply click the desired module tab. While list views only show key fields, you can click the record's name to open the record view and access additional details. For in-depth information about list views, please refer to the List View section of this page.

Viewing via Record View

Each record's record view displays thorough record information including all relevant fields followed by subpanels of related records belonging to various modules. The record view can be reached by clicking a record's name link from anywhere in the application. For in-depth information about record views, please refer to the Record View section of this page.

Viewing via Recently Viewed

As you work, Sugar will keep track of which records you have recently viewed. Click the triangle on the right of any module's tab to see a list of the 3 records you most recently viewed in that module. You can also click the triangle to the right of the Sugar cube icon to see records recently viewed from across all Sugar modules. Clicking a record name within these lists will open it in record view.
711-recent

Viewing via Dashlets

Sugar Dashlets allow you to get a quick view of various records, activities, reports, etc. Dashlets may be added to your Home page or to the intelligence pane of any module's list view or record view. List View dashlets display lists of records and their desired fields. Clicking a record's name from any dashlet will open it in record view. For more information on using dashlets, please refer to the Intelligence Pane documentation.
711-dashlet

Viewing via Activity Streams

The activity stream allows you to see record changes and user posts relevant to records you are following in Sugar. Activity stream posts will display records when that record was modified or when a user mentions the record in their post. Clicking the record's name link will open its record view. You can also preview the record directly from the activity stream by clicking the Preview button to the right of the post. For more information on viewing records via the activity stream, please refer to the Activity Streams documentation.
stream-preview-78

Viewing via Preview

Record previews are accessible anywhere you see the Preview button (eye icon), usually to the right of a record's row. Click on the preview icon to expand or refresh the intelligence pane and view details about the record without leaving the current page. Record previews are available from list views, subpanels, duplicate search, Search and Select drawers, and activity stream posts.

In the preview, Sugar displays the topmost fields from the module's record view and the record's most recent activity stream entries in the intelligence pane. To view all of the fields that are on the record view, click "Show more...". From module list views, left and right arrow buttons at the top of the intelligence pane allow you to preview the next or previous record of the current list. To close a preview, simply click the "X" in the corner of the intelligence pane.
711-preview

Viewing via Reports

The Reports module allows you to build, run, and manage reports to gather key record information. In addition to only displaying the fields and relationships you desire, reports can utilize complex filters to display specific subsets of your records. Once a report is run, you can click any record's name link in the results to open its record view. Please note that you can only directly access record views with Rows and Columns-type and Summation with Details-type reports as Summation-type and Matrix-type reports do not include hyperlinks in their display columns. For more information on using reports, please refer to the Reports documentation.
viewing via reports-tiny

In addition to navigating to the Reports module and finding or building relevant reports, you can use the View {Module} Reports option to see only the reports based on the desired module.
711-view-reports

Please note that your ability to access reports may be restricted by a role. For more information on roles, please refer to the Role Management documentation. Check with your system administrator if you cannot access the Reports module.

Searching for Records

Each module's list view includes a list view search to help you easily locate records in a module-specific manner. Matching records will be displayed in the list view below. Global search allows users to search for information across their entire Sugar database rather than restricting searches to a specific module. In both searches, Sugar automatically appends the wildcard character (%) to the end of your search phrase. This allows the system to retrieve all records that start with the keyword entered in the search. If you would like to broaden the search, you can use the wildcard at the beginning of your text as well (e.g. %services). This will pull up any record that has the word "services" in the name, regardless of how it starts or ends.

Global Search

For a brief introduction to global search, please refer to the Global Search section of this page. For in-depth information on both search methods as well as how wildcards are used in the different methods, please refer to the Search documentation.

List view search enables users to easily search by the record's name within an individual module and pull up matching records in the list view. The search also provides a Filter option allowing you to narrow your search further using the available options as follows:

  • Create : Create a new custom filter which you can use to filter your search
    • Note: You can also click "Create" to the right of the Filter option.
  • All "Module Name" : Returns all records in the module (e.g. Accounts) to which you have access
  • My "Module Name" : Returns only records assigned to you
  • My Favorites : Returns only records you have marked as favorites
  • Recently Created : Returns only records you created in the module within the last 7 days
  • Recently Viewed : Returns only records you have viewed in the module within the last 7 days

711-lv-filter

When you choose a filter, Sugar will return records that match both the selected filter and any name provided in the open Search box in the filtered list view results. For example, if you select "My Accounts" in the Filter options and enter a query in the Search box, Sugar will only return account records that are assigned to you and have names that match the search term. Once the search is complete, the relevant results will populate in the list view below the search bar.
711-lv-filter-wildcard

Note: The yellow highlighting in this image has been added for effect and will not appear in the application.

When you perform a search using a filter from the filter list, the filter will continue to apply if you navigate away from and then return to the module's list view. Any text query entered in the open Search box, however, will not be preserved. 

To see all account records to which you have access, simply select the All Accounts option in the filter and remove any text from the search bar:
711-clear-filter

To clear an applied filter, click the "x" on the selected filter option (e.g. My Accounts) in the Search box; to clear a text query from the search, click the "x" on the right end of the search box:
711-remove-applied-filter

To update the filtered list view with the most recent results, click on the Refresh icon to the right of the search box:
711-refresh

Please note that you will only be able to see records as allowed by your team membership, user access type, and assigned roles. For more information on teams and roles, please refer to the Team Management and Role Management documentation. Administrators can configure what fields appear on the List View Search via Admin > Studio for certain modules. For more information on editing layouts, please refer to the Studio documentation.

Creating a Filter

Users can also create new filters via the Create option in the Filter list of the search bar. This allows users to add custom, complex filter options when searching in the module's list view. You have the option to add multiple fields to your new filter by clicking the Plus button to the right of the filter selection dropdown lists and set select operators along with their value(s). A filter's criteria need to be true for a record in order for it to appear in the list view search result. Additionally, filters with no specified values may be saved as a custom filter to act as a filter template when a user often searches using the same fields but with varying values. Please note that only fields you have view access for will appear in the Filter list when creating a search filter.

When you run a search using a created filter, the search will be preserved when you navigate away from the module. Returning to the list view will automatically display the results of your last filter.

The following steps cover creating a new Assigned to filter in the Accounts module as an example:

  1. Click the Filter option on the Accounts search bar then select "Create".
    711-filter-create
    • You can also click "Create" to the right of the Filter option.
  2. Select the field you wish to add to your filter as well as the condition and matching criteria.
    • Note: Only fields you have view access for will be available to add in the Filter list.
  3. To add additional fields to the new filter, click the Plus button to the right of the filter.
    • To remove fields from the new filter, click the Minus button to the right of the filter.
    • To clear any filter values (e.g. Will Westin), simply click the "x" to the right of the value or select "Reset" to the left of the Save button.

711-filter-builder

The list view will automatically display results matching your filters as you create and modify the criteria. To view the most recent matching records for an existing filter, click on the Refresh button to the right of the search box.

Note: When filtering a relate field using "is any of" or "is not any of", you can select up to 20 values.

Saving a Filter

Saving a filter will preserve the chosen fields as well as the condition(s) of the matching value(s). Additionally, it will allow users to easily select previously created and saved filters from the Filter options.

The following steps cover saving a new search by Name filter for the Accounts module as an example:

  1. Create a new filter to perform a search on your desired fields.
  2. Enter a name for the new filter (e.g. "Accounts assigned to Sarah and Will").
    711-filter-name
  3. Click "Save" to add this filter to the module's Filter options.

You can also create and save a filter without entering any filter values (e.g. Sarah Smith) if you wish to enter new values each time you utilize the filter. When re-using the filter simply enter the appropriate filter value(s) and the list view will display the matching results. Once you are done with the filter, click "Reset" to the far right of the filter's name to clear the filter value(s).

The custom filter can always be edited as necessary by selecting the filter and updating the fields, conditions, values, etc. via the filter details panel. Once the necessary updates have been made, click "Save" to preserve the changes.

Please note that you can easily delete custom filters by selecting the filter (e.g. Accounts assigned to Sarah and Will) from the Filter list, clicking the filter's name on the Search bar, then clicking "Delete" on the filter details panel.

List View

A module's list view displays all records meeting the current search criteria and to which users have access. You can view the basic details of each record within the field columns of the list view or click the record's name to open the record view. To access a module's list view, simply click the module tab (e.g. Accounts) in the navigation bar at the top of Sugar.

Please note that you will only be able to see records as allowed by your team membership, user access type, and assigned roles. For more information on teams and roles, please refer to the Team Management and Role Management documentation.
711-list-view

Users with administrator or developer access have the ability to change what fields are visible in the list view via Admin > Studio. For more information on editing layouts, please refer to the Studio documentation.

Total Record Count

The list view displays the total count of records (e.g. "20 of 21+") on the upper left of the page next to the module name (e.g. Accounts). The count will capture the total number of records displayed on the current set of list view results. If there are additional records in the list view results set, a hyperlinked number (e.g. "21+") will display to the right of the initial count. Simply click the hyperlinked number in the parentheses to view the total count of all records in the list view result set.
711-record-count

Please note that, by default, Sugar displays 20 records per list view results set, but administrators can change the number of records displayed via Admin > System Settings. For more information, please refer to the System documentation.

Create Button

The Create button on the upper right of the module's list view allows users to easily create new record's in the module. Once you click the button, the module's record view layout opens where you can enter all of the relevant information to create the new record. Please note that administrators can configure the Record View layout via Admin > Studio. For more information on configuring layouts, please refer to the Studio documentation.
711-list-create

List View Search

To search for a specific record within a module or for a list of module records filtered by name, use the search bar located above any module's list view. Start typing a word into list view search and Sugar will retrieve all records that start with the given characters.
711-list-search

List view searches also support the system wildcard character (%) to retrieve results that contain certain characters in their name or title. For more information about performing module-specific searches via list view, please refer to the Search documentation.

Refreshing Search Results

The list view's Refresh button provides a quick way to reload the results of any filtered or unfiltered list view without reloading the browser or losing any filter or search criteria you may have set. Simply click on the Refresh button to the right of the search box to load the most current list of matching records.
711-refresh-filter

Checkbox Selection

Users can perform various types of actions on module records by first selecting the desired records from the module's (e.g. Contacts) list view. To select individual records from the list view, mark the checkbox on the left of each record row.
711-checkbox

To select all records displayed on the current set of list view results, click the checkbox to the left of the Actions menu. Please note that a dialog will appear below the list view's column headers indicating that you have selected all records on the list view's current result set (e.g. 20). To select all records in the search results, click "Select all records" in the dialog.
711-select-all

If you wish to clear the selection for all records on the list view result set, simply click "Clear selections" in the dialog. You can also clear the selections for all records by clicking the checkbox option again to remove the check marks.
711-clear-selection

Mass Actions Menu

The Mass Actions menu to the right of the checkbox option allows you to perform various actions on the currently selected records. Please note that the actions available to perform will vary between each of the modules. To access the Mass Actions menu simply click the triangle next to the checkbox option.
711-mass-actions

For more information on the actions available within a specific module, please refer to the list view section in the application guide pertaining to that module. The most common actions available in the Mass Actions menu are as follows:

Menu Item Description
Email For modules which include an Email field, send an email to one or more records' email addresses
Mass Update Mass update one or more records at a time
Merge Merge two or more duplicate records
Recalculate Values For modules with a calculated field, updates calculated values to reflect recent changes to calculated fields made via Admin > Studio
Delete Delete one or more records at a time
Export Export one or more records to a CSV file

The following sections will cover the most common type of actions available in the Mass Actions menu.

Favorite Designation

Users have the option to mark records as favorites via a module's list view. This allows users to designate records that are important or will be viewed often so that they can easily be accessed via the search filter's My Favorites option or from the module tab's Favorites option. In the module's list view, the star on the left of each record's row is orange once marked to indicate a favorite record. For more information on how to mark records as favorites, please refer to the Favoriting Records section of this documentation.

The following steps cover marking records as favorites via the Accounts list view as an example:

  1. Navigate to the Accounts list view by clicking the Accounts module tab.
  2. Use the List View Search to find the Account records you wish to mark as favorites.
  3. Mark the star icon on the left of each desired account's row.
  4. To remove the account as a favorite, click the star again to revert it to white.
    711-lv-favorite

Column Reordering

List view provides the ability to reorder columns by dragging and dropping the title of the column to the desired location. The new column order will remain for a user upon subsequent visits to the module until the user's browser cache is cleared. You can reset the column order back to the default view by clicking the Gear icon to the far right of the list-view column headers and selecting "Reset default view". Please note that this option only appears if the current column order differs from the default order.
711-col-reorder

Column Resizing

Users can easily adjust the size of columns in list views per their viewing preference. Simply place your cursor on the column divider, and when the left-and-right arrow appears, click and drag the column to the desired size.

The set column width will be preserved when you navigate away from the page. Sugar will render the preferred column size across sessions until the user removes or resets the relevant browser cookies. You can reset the column width back to the default size by clicking the Gear icon to the far right of the list-view column headers and selecting "Reset default widths". Please note that this option only appears if at least one of the column widths in the current list view is different from the default column width.

Changes to the column width made by administrators in Studio are only respected if the user has not resized the specific column in the list view. The column width set by the user will supersede the default column width configured in Studio until the user resets the list view back to the default widths. For more information how admins can set column widths, please refer to the Studio documentation.

Note: Sugar enforces a minimum width for currency fields (e.g. Best, Likely, etc.) in list view columns to prevent the columns from being collapsed beyond this limit.
711-col-resize

Column Sorting

Sugar's list view provides users the ability to sort all of the current search results by a field column in either ascending or descending order. To sort by a field or switch the sort direction, click the column header noting that the fields which allow sorting will have a pair of arrows. You can click the column header again to reverse the sort order.

Note: List views may only be sorted by one column at a time and cannot be sorted by custom relate fields or the Tags field.
711-col-sort

Column Selection

Sugar gives users the ability to personalize the list view by specifying which fields they want to be displayed in the list view. You can click the Column Selection icon to the far right of the list-view column headers to see the list of available fields. Click a field name to toggle whether or not it is included as a column in your list view. Please note that administrators have the ability to configure what fields are available to display in the list view via Admin > Studio. For more information on configuring fields to display in the list view, please refer to the Studio documentation.
711-choose-cols

Preview

Users can preview a record's details directly from the module's list view by clicking the Preview icon to the far right of each record's row. Please refer to the Viewing via Preview section of this page for more information.
711-lv-preview

Record Actions Menu

The Record Actions menu to the right of each record's Preview button allows users to edit, follow, delete, etc. specific records directly from the list view. For example, users have the ability to inline edit the display column fields directly from the list view by clicking the triangle next to the Preview icon then selecting "Edit".
711-lv-record-actions

The options in the Record Actions menu allow you to perform the following operations:

Menu Item Description
Edit Edit this record
Follow Follow this record
Delete Delete this record
Convert For the Leads module, convert this lead

More Records

The list view loads an initial number of records meeting the current search criteria with the option to show additional results at the user's request. By default, Sugar displays 20 records per list view results set, but administrators can change the number of records displayed via Admin > System Settings. For more information on changing the number of displayed records, please refer to the System documentation. To load the next set of list view results, simply click the More "Module Name" (e.g. More accounts) link at the bottom of the list view.
711-more-records

Activity Stream

The module's activity stream displays user posts made directly via the module as well as record posts relevant to the module record. To view the module's activity stream, simply click the Activity Stream button to the right of the list view's search bar. For more information on how to add posts to the activity stream, please refer to the Activity Streams documentation.

You can add comments to posts using the comment button to the far right of each post. You can also preview the record referenced in record posts by clicking the Preview button to the right of each post. The activity stream can be filtered to only display certain messages (e.g. Messages for Create, Messages for Update, etc.) by clicking "Filter" above the post input box and selecting the desired message type. You can also refresh the activity stream to view its latest entries by clicking the Refresh button to the right of the filter area.
711-activity-stream

Dashboards

To the right of list views, the intelligence pane displays dashboards when not displaying a record preview. Dashboards are sets of dashlets configured for the specific list view to display useful Sugar data. An out-of-the-box default dashboard will likely be initially displayed on your list view intelligence pane. Sugar admins are able to create and push custom default dashboards to your views. You may also create personal dashboards using the dashlets and configurations that best suit your business needs. All dashboards can also be shared with teams of users who can the pull the dashboards to their views as desired. Ensure the intelligence pane is expanded using the Arrow icon at the top right of the list view. For more information, please refer to the Dashboards and Dashlets documentation. 
711-lv-dashboard 

Record View

The module's record view displays thorough information regarding the record such as name, email address, phone number, etc. Beneath the fields, you can toggle between viewing a record's subpanels of related records (e.g. Opportunities, Leads) and the record's activity stream. The record view can be reached by clicking a record's link from anywhere in the application including from the module's list view.

Please note that you will only be able to view a record according to your team membership, user type, and role restrictions. For more information on teams and roles, please refer to the Team Management and Role Management documentation. Users with administrator or developer access have the ability to change the record view by configuring the layout via Admin > Studio. For more information on editing layouts, please refer to the Studio documentation.
recordview-tiny

Favorite Designation

Users have the option to mark records as favorites via the module's record view. This allows users to designate records that are important or will be viewed often so that they can easily be accessed via the search filter or from the module tab. In the module's record view, the star to the right of the record's name is gray once favorited. 
recordview-favorite-tiny

Following Designation

Users can also choose to follow specific records to which they have access to in Sugar by clicking the Follow button to the right of the record's name. The ability to follow records allows each user to personalize their activity stream by specifying which records' posts should appear on the activity streams displayed on their Home page and in module list views. Please note that you will automatically follow records that you create as well as records that are assigned to you. You will not, however, automatically follow records you import. Should a user lose access to a record in Sugar, they will automatically stop following that record. Instructions for toggling the Following button on a record view, please refer to the Following via Record View section of this documentation.
recordview-follow-tiny

Next or Previous Record

On the upper right of the record view, there are two buttons that allow you to page through each record in the module's list view's current search results. Clicking the Left arrow button displays the previous record of the current search results while clicking the Right arrow button displays the next record of the current search results.
recordview-nav-tiny

Actions Menu

The Actions menu on the top right of each module's record view allows you to perform various actions (e.g. edit, copy, delete) on the current record. 
UI RecordView ActionsMenu

Please note that certain action items (e.g. Convert Lead) in the Actions menu can vary between the various modules. The following sections will cover the most common action items across the modules. For more information on a specific action not listed below, please refer to the record view actions menu section for the specific module's documentation in the application guide.

Menu Item Description
Edit Edit this record
Share Share a link to this record via email
Download PDF Download record information as a PDF file
Email PDF Email record information as a PDF attachment
Find Duplicates Locate potential duplicates of this record
Copy Duplicate this record
Historical Summary View a historical summary of activities (e.g. calls, meetings related to this record
View Change Log View a sequence of changes made to this record
Delete Delete this record

Show More

The record view typically displays a few key fields (e.g. website, mobile phone, office phone) on the business card panel with the option to view more fields by clicking the "Show more..." link on the bottom left. Please note that administrators can configure the fields that appear on the business card panel via Admin > Studio > Layouts > Record View. For more information on editing layouts, please refer to the Studio documentation. 
UI RecordView ShowMore

Subpanels

Beneath the module (e.g. Accounts) record's fields are subpanels containing related records from various modules (e.g. Contacts, Leads, Opportunities). You can create a related record as well as link an existing record directly from the subpanel. Once the records appear within the subpanel, users can preview the record's detail and edit the record's data directly from the record view. Please note that the subpanels are viewable when you access the Data View section of the module's record view.
sub-dataview-78

Note: Administrators may choose to disable a module's subpanels for the entire instance via Admin > Display Modules and Subpanels. For more information, please refer to the Developer Tools documentation.

Subpanels under a module's record view contain its related records. Each relationship between two modules has a type, and that type determines if the relationship produces a field or a subpanel for each side. When a record of the primary module can be related to only one record of a second module (i.e. 1-1 or M-1 relationships), the relationship is displayed as a field on the primary module. When the record can be related to multiple records of a second module (i.e. 1-M or M-M relationships), the relationship is displayed as a subpanel instead since subpanels can hold many records.

For example, an account may be related to multiple contacts, so the related contacts are displayed in a subpanel on the account record. Administrators or users with developer-level role access may choose to change a subpanel's title and included fields by configuring the layout via Admin > Studio to provide visibility to the most important fields. For more information on modifying subpanels, please refer to the Studio documentation.

Related-record subpanels provide the following information and capabilities:
subpanel-elements2-78

  • Record Count : Subpanel headers display the total count of related records (e.g. "5 of 6+") next to the module name. The count captures the number of records currently displayed with an additional, hyperlinked number (e.g. "6+") where there are more records than currently displayed. Click the hyperlinked number to see the total count of related records.
  • Collapse or Expand : Click anywhere in the subpanel's header to collapse or expand it. Subpanels will remain collapsed or expanded on future visits to the module.
    • Note: Administrators can choose to disable the sticky feature and collapse all subpanels by default via Admin > System Settings. For more information, please refer to the System documentation.
  • Column Widths : Place your cursor on the column divider and, when the double arrow cursor appears, click and drag the column to the desired size. Please note that the column width will not be preserved when you navigate away from the page.
    • Note: Sugar enforces a minimum width for currency fields in list view columns to prevent the columns from being collapsed beyond this limit.
  • Column Sort : Click a column header to sort the subpanel's items by that value. Clicking the same header again will reverse the sorting order (e.g. from ascending to descending).
  • Create a New Linked Record : Click the Plus button on the upper right of a subpanel to relate a new record to the record you are currently viewing. Please note that the Link Existing Record option is not available when the relationship is required in the related module (e.g. in an account's Opportunities subpanel).
    • Note: Because creating a new related record opens a drawer on top of the current record view, you should use the Cancel button to return to record view. Using the browser's back button will return you to the previous page.
  • Link Existing Record : Click the triangle to the right of the Plus button then select "Link Existing Record" to relate existing records to the record you are currently viewing.
    • Note: Because linking an existing record opens a drawer on top of the current record view, you should use the Cancel button to return to record view. Using the browser's back button will return you to the previous page.
  • Favorites Designation : Click the star on the left of a record's row to toggle it as a favorite. A dark gray star indicates that the record is a favorite while a white star indicates it is not. For more information, please refer to the Favoriting Records section of this page.
  • Hyperlink Fields : Blue field values, such as record names, may be clicked to open the record in record view. Record view provides a complete picture of the record and is described in detail in the Record View section of this page. Email addresses also appear in blue and can be clicked to compose an email to that recipient.
  • Record Actions Menu : Click the triangle on the right of a record's row to access the Record Actions Menu which includes the following options:
    • Preview : To preview a record by displaying its fields and activity stream in the right-hand side drawer, click the Eye icon to the far right of the record's row. For more information, please refer to the Viewing via Preview section of this page.
    • Edit : To inline edit the record directly within the subpanel, choose "Edit" from the Actions menu on the right of the record's row and click "Save" to preserve the changes.
    • Unlink : To delete the relationship between the two records, choose "Unlink" from the Actions menu on the far right of the record's row. This removes the relationship but does not delete the record itself. Please note that the Unlink option is not available when the relationship is required in the related module (e.g. in an account's Opportunities subpanel).
    • Additional Options : Some modules may have additional options available which are covered in the individual module's documentation.
  • More Records : By default, Sugar displays up to five records in each subpanel though administrators can alter the number via Admin > System Settings as described in the System documentation. If additional related records exist, click "More <Module Name>..." (e.g. "More Accounts...") at the bottom of the subpanel to load the next set.

Filtering Subpanels

While in Data View, all of the related records will be displayed beneath the record's fields. Users have the ability to search for records which appear in the subpanels as well as filter the view to only display a specific module (e.g. Leads, Contacts). To locate a record by name, enter the keyword into the Search bar, and the subpanel(s) with the matching record(s) will appear below.
sub-filter-78

To filter, simply click the Related option to the far left of the Search bar and select the module whose subpanel you wish to view. Filter and search may be combined to only display matching records within a selected module. To see all subpanels to which you have access, simply select "All" in the Related options and remove any text from the search bar. When you run a search using a saved or created filter, the search will be preserved when you navigate away from the page. Returning to the page will automatically display the results of your last filter. Please note that search strings entered in the open Search box are not preserved when navigating away.

When a Sidecar module (e.g. Contacts, Leads, Tasks) is selected from the Related options, you have the option to filter the related subpanels further using one of the available options (e.g. My Favorites, Recently Created). Please note that you can also create custom filters for related Sidecar modules. Once the related module (e.g. Contacts) is selected, either click the Filter option and select "Create" or click "Create" to the right of the Filter option. For more information on creating a related records filter, please refer to the Creating a Related Records Filter section of the Search documentation.
sub-filteroptions-78

Reordering Subpanels

Users can easily move subpanels to a new location on the record view by dragging and dropping the subpanel's header. The new subpanel order will remain for a user upon subsequent visits to the module until the user's browser cache is cleared.

Refreshing Subpanels

To refresh the results of a filtered or unfiltered subpanel view, simply click on the Refresh button to the right of the search box. This will reset the current view of expanded subpanels with the most current results that match your search and filter criteria. Please note that subpanel results in a collapsed state are not affected by the Refresh button.
refresh-subpanel-78

Activity Stream

The record view's activity stream displays user posts and record posts specific to the individual module record. To view the record's activity stream, simply click the Activity Stream button below the record's fields. Users can view all posts in the record view's activity stream even if they do not follow the record in Sugar. Please note that you must follow the record if you wish to view the record view posts via the Home page or List View activity stream. For more information on how to add posts to the activity stream, please refer to the Activity Streams documentation. You can add comments to posts by clicking the Comment button to the far right of each post, entering in your comment, then clicking "Reply". You can also preview the record referenced in the record post by clicking the Preview button. The activity stream can also be filtered to only display certain messages (e.g. Messages for Create, Messages for Update) by clicking "Filter" above the post input box then selecting the desired message type.
UI RecordView ActivityStream

Dashboards

To the right of record views, the intelligence pane displays dashboards when not displaying a related record preview. Dashboards are sets of dashlets configured for the specific record view to display useful Sugar data. An out-of-the-box default dashboard will likely be initially displayed on your record view intelligence pane. Sugar admins are able to create and push custom default dashboards to your views. You may also create personal dashboards using the dashlets and configurations that best suit your business needs. All dashboards can also be shared with teams of users who can the pull the dashboards to their views as desired. Ensure the intelligence pane is expanded using the Arrow icon at the top right of the record view. For more information, please refer to the Dashboards and Dashlets documentation. 
UI RecordView Dashboards

Intelligence Pane

Intelligence panes display on list views, record views, and to the right of the Home page activity stream. They provide users with valuable record information via dashboards as well as allowing Sugar records to be previewed.

Dashboards

Most intelligence panes have out-of-the-box default dashboards with a set of commonly used dashlets. Admin users may also have created default dashboards which are pushed to teams of users. In addition, individual users can create their own personal dashboards with whichever dashlets they wish to use. Any dashboard can also be shared to additional teams who can then pull the dashboard into their intelligence panes for use.

Please refer to the Dashboards and Dashlets documentation for in-depth documentation about using dashboards as well as information about commonly used dashlets.

Previews

Users can preview a record's details by clicking the Preview icon to the far right of a record's row or activity stream post. The preview appears in the intelligence pane to the right of the Home page's activity stream and on list views and record views. The preview displays the topmost fields from the module's record view and the record's most recent activity stream entries. Please note that administrators can configure the fields that appear on the record view layout via Admin > Studio > Layouts > Record View.

Note: For more information on activity streams, please refer to the Activity Streams documentation. 

Viewing Previews

There are various options available for viewing previews in Sugar including via the list view, record view, and activity stream. Previewing allows users to easily view key information regarding a record directly from the intelligence pane without navigating away from the current page. Users can mark a record to follow or unfollow via the preview by clicking the Follow or Unfollow button within the record's details. Clicking the hyperlinks (e.g. account name, website, email address) within the preview allow you to access the record view, external company website, compose email, etc. 

Previewing From List Views

Users can view a record's topmost fields directly from the module's list view by clicking the Preview icon to the far right of each account's row. The intelligence pane will display the record's details with key information regarding the record as well as any related activity stream information. 
UI ListView Preview

Previewing From Record View

Users can also view a record's details from the module's record view by clicking the Preview icon to the far right of each record row in the subpanel. The intelligence pane will display the record's details with key information regarding the record as well as any related activity stream information. 
UI RecordView Preview

Previewing From Activity Streams

In addition, you can also preview the record referenced in activity stream posts from the Home page, list view, and record view activity stream by clicking the Preview button to the right of each post. Please note that preview is only available for Create, Update, Relate, and Un-relate-type posts in the activity stream. For more information about previewing activity stream posts, please refer to the Previewing Posts section of the Activity Streams documentation.

The intelligence pane displays the topmost fields from the module's record view and the record's most recent activity stream entries.  
UI ActivityStream Preview

Users can view a record's details directly from the View All Results page for Global Search by clicking the Preview icon to the far right of each record's row. The intelligence pane displays the topmost fields from the module's record view and the record's most recent activity stream entries. For more information on previewing via the View All Results page, please refer to the Search documentation. 
IntelligencePane PreviewingFrmGlobalSearch 7.7

Show More

In the preview, Sugar displays the topmost fields from the module's record view. To view all of the fields that are on the record view, click "Show more...". Please note that administrators can configure what fields appear on the business card panel via Admin > Studio > Layouts > Record View. For more information on editing layouts, please refer to the Studio documentation. 
UI Preview ShowMore

Previewing a Record's Activity Stream

When previewing a record via the intelligence pane, you can also view any related activity stream posts which will appear below the record's detail. Please note that you cannot create new posts or comment on posts via the activity stream when previewing a record. For more information on creating posts and commenting on posts, please refer to the Activity Streams documentation. 
UI Previewing Record'sActivityStream

Previewing Next and Previous Records

Above a previewed record in the intelligence pane, there is a Left and Right arrow button that allows you to scroll through the next and previous records. Clicking the Left arrow button displays the previous record's preview while clicking the Right arrow button displays the next record's preview. When previewing from the module's list view, you can scroll through the list view's current search results. When previewing a related module record from a module's record view, you can scroll through the list of related records in the specific subpanel. 
Next_Previous_Record

Closing a Preview

If you no longer wish to preview the records, you can simply close the preview by clicking the "X" on the upper right of the intelligence pane. Please note that the dashboard view will display again on the intelligence pane once you close the preview. 
UI IP ClosePreview

Editing Records

Records may be edited at any time to modify or add information. Edits can be made via record view or list view as detailed below. For instructions on how to edit the various field types, please refer to the Editing Fields section below.

Please note that your ability to edit records in Sugar may be restricted by a role. For more information, please refer to the Role Management documentation. Check with your system administrator if you do not see the edit options.

Editing Inline via Record View

Users can edit individual fields in a record view without entering the full edit mode by clicking the field name. Fields which are available for inline editing will display a pencil icon when hovering on the field name or value. After entering your desired values, click "Save" to preserve your changes to one or several fields. 
UI RecordView InlineEdit

Editing via Record View

You can edit many fields at once via the record view by clicking the Edit button on the upper right of the page. Once the record view layout is editable, update the necessary fields, then click "Save" to preserve your changes.
UI RecordView Edit

Editing Inline via Subpanels

Beneath the record's fields are subpanels containing related records from various modules. You can edit individual fields (e.g. Email, Office Phone) for records directly within the subpanel without entering the full edit mode. Simply click the Actions menu to the far right of the record's row and select "Edit".
Contacts Subpanel Inline Edit

The fields on the record's row will become editable and allow users to type or select a new value. You can click the double arrow icon on the upper right of the page to expand the subpanel list view's width to make editing easier. Click "Save" to preserve your changes.

Editing Inline via List View

You can also edit individual fields on a module's list view without entering the full edit mode. Click the Record Actions menu to the far right of the record's row and select "Edit".
edit-list78

The fields on the record's row will become editable and allow users to type or select a new value. You can click the double arrow icon on the upper right of the page to expand the list view's width to make editing easier. Click "Save" to preserve your changes. After saving, please refresh the page to have any list view filters be applied to the new record's values.

Note: Text area fields are not inline editable from list views.

Editing via List View Preview

Users have the option to edit fields directly in a record's preview when previewing from the module's list view. An administrator must first enable the feature via Admin > System Settings as described in the System documentation.

Navigate to a module's list view and click the eye icon to the far right of a record's row in order to open the preview. Hover over the Preview header and then click the pencil icon. 
edit-preview-78

The fields on the record's preview will become editable and allow you to type or select a new value. Click "Save" to preserve your changes.

Mass Editing via List View

Mass Updating allows you to apply the same changes to multiple records at once. Administrator users or users with developer-type role access can control which fields are available during mass update via Admin > Studio. Fields with the data type of date, datetime, dropdown, multiselect, radio, relate, flex relate, or tags can be made available for mass updating. For more information on configuring the mass update fields, please refer to the Studio documentation. After using list view search to locate the desired records, you can choose individual records or use the Select All option to modify all of the current results. Using the Select All option will allow you to update up to 1000 records at a time. If you wish to update more than 1000 records or update a specific group of records from the list view, use filters to perform the updates in smaller batches.

Please note that your ability to mass update may be restricted by a role. For more information on roles, please refer to the Role Management documentation. Check with your system administrator if you do not see the Mass Update option.

The following steps cover mass updating account records as an example:

  1. Navigate to the Accounts list view by clicking the Accounts module tab.
  2. Use the list view's list view search to identify accounts you wish to modify.
  3. Select the desired accounts then choose "Mass Update" from the Actions menu.
    UI ListView MassUpdate
  4. The Mass Update panel will appear below the search bar. Set values for the field(s) you wish to alter. The following options may be available in the Mass Update panel:
    • Add Row/Remove Row : To mass update several fields at once, click the plus icon to the right of the row.
    • Append {Field}(s) : When mass updating a field that may contain multiple values (e.g. Tags, Teams), Sugar will display a checkbox labeled "Append {field}(s)", where {field} is the name of the field you have selected. This option is enabled by default to prevent loss of data by adding the new values to any existing data in the updated field. Disable the checkbox if you prefer to overwrite any existing data in the updated field.
      append-tags-77
    • These additional options appear when mass updating the Teams field:
      • Set as Primary Team : Use the star icons to specify which team, if any, should be set as the primary team on the updated records. A primary designation is required when the Append Team(s) option is disabled.
      • Add Team/Remove Team : Specify multiple teams by using the plus and minus icons adjacent to the Team selection field.
        team-update-78
  5. Click "Update" to save the changes to all of the selected account records.

Note: If your administrator has enabled team-based permissions, you may also see a Lock button or a "Selected" box on the Teams field. Please refer to the Using Team-Based Permissions section for more information.

Editing Fields

Sugar records include a variety of field types which enable you to capture all of the different kinds of data which are important to your organization. While many fields are available for use on each module out-of-the-box, administrators and users with developer-level role access have the ability to add fields of these various types to modules via Admin > Studio as described in the Studio documentation. Studio may also be used to configure fields by, for example, making fields required, allowing them to be mass updated, making their values calculated, and specifying when they should be visible.

Descriptions and instructions for editing different field types are available below:

  • Text : Text fields allow users to enter a word or brief phrase by clicking into the field and typing. Text fields will accept any combination of characters (i.e. letters, numbers, spaces, and symbols) but have a 100-character limit by default. Administrators can edit the maximum character length restriction via Admin > Studio.
    text-field77
  • Text Area : Text area fields allow users to enter large amounts of text by clicking on the field and typing. Administrators can modify the default display size of a text area field via Admin > Studio, but this will not limit the number of characters that can be entered by a user. Most browsers supported by Sugar will allow the user to resize an active text area field temporarily by dragging the bottom corner of the field to the desired width and height.
    textarea-field77
  • Integer : Integer fields allow users to enter whole number values (e.g. 850) by clicking on the field and typing. Administrators can specify a minimum and maximum value for the field via Admin > Studio. 
    UI EditingFields Integer
  • Dropdown : Dropdown fields provide a list of values where only one value can be selected at a time. The list will be collapsed to only display the selected value except during editing, making it appropriate for longer lists of values. Click the selected value to see the full list. Clicking the desired value will replace it as the selected value.
    UI EditingFields Dropdown
  • Multiselect : Multiselect fields provide a list of values where one or more values can be selected at a time. The list will be collapsed to only display selected values except during editing, making it appropriate for longer lists of values. Click the blank space to the right of selected values to see additional options. Click the x on a selected value to de-select it.
    UI EditingFields Multiselect
  • Radio : Radio fields provide a list of values where only one value can be selected at a time. The entire list of all values will be displayed at all times, making it appropriate for shorter lists of values. Click the circle of the desired value, and any previously selected value will be deselected automatically. 
    UI EditingFields Radio
  • Checkbox : Checkbox fields provide a boolean type typically used to answer a yes or no question. Click the box to toggle whether it is checked or not.
    UI EditingFields Checkbox
  • Date : Date fields allow users to specify a particular date by either typing a date in the provided format or clicking the Calendar icon and selecting it via the date picker. Click the month and year (e.g. "January 2018") to select the desired month or use the arrows to navigate to the desired month. To set the year, click the month and year at the top of the picker, then click the year at the top of the picker, and then select the desired year. Once the month and year are set, click the desired date below to set the date and close the picker.
    UI EditingFields Date
  • Datetime : Datetime fields allow users to specify both a particular date and a time. The date portion is set just like a date field as described above. The time portion can be set by typing a time in the provided format or clicking the Clock icon and selecting it via the dropdown.
    UI EditingFields Datetime1
  • Relate : Relate fields allow users to select a record from a single module. Both relate fields (which are visible via Admin > Studio > {Module Name} > Fields) and one-sided relationships (i.e. one-to-many and one-to-one) are represented by the same relate field user interface. Type the first few characters of the desired record and either select from the type-ahead results or click "Search and Select..." at the bottom for a more robust search.
    UI EditingFields Relate
  • Flex Relate : Flex relate fields require users to select first the module and then a record from that module to relate to the current record. The module selector works like a dropdown field while the record selector works like a relate field, both of which are described above. You can click the "x" to the right of the selected record's name (e.g. ABC Company) to clear out the value. Please note that a module may only have one flex relate field.
    flex-relate-77
  • Email Address : Email address fields contain one or more email addresses for a single record; email addresses are entered by clicking in the field and typing or pasting the address. The following options are available when editing an Email Address field:
    • Add/Remove email : Add additional email address fields by clicking the plus button. Click the minus button to remove the adjacent address.
      email-addremove-77
    • Primary : A white star with a black background represents the primary email address on a record. This will be the default address that Sugar will find when the record is included in email campaigns and other send-message events performed within the application. On a given record, only one email address can be the primary one. If a record contains only one email address, it will be set to primary by default.
      email-primary-77
    • Opted Out : The button with a slashed circle indicates whether or not an email address has been opted out from email marketing campaigns. Sugar automatically enables the corresponding Opt-Out button when a recipient clicks the opt-out link in an email message sent through Sugar's Campaigns module. When enabled, the button will have a black background. Users may also manually enable this button to exclude the email address from future email campaigns. For more information about opt-outs and campaigns, please refer to the Campaigns documentation in the Application Guide.
      email-optout-77
    • Invalid : Invalid or undeliverable email addresses are represented by a black button with a white exclamation point. Sugar automatically marks email addresses as invalid if they are returned via the recipient's mail server during the distribution of an email campaign. Users can also manually toggle the invalid designation on and off by clicking the Invalid button next to the email address. Sugar will not permit users to send messages to invalid email addresses from anywhere within the application.
      email-invalid-77
  • Tags : The Tags field allows users to enter keywords or phrases in order to connect Sugar records by common attributes that may not be defined via basic database fields. Once a new tag has been created, it can be re-used by any user in any module that contains a Tags field. To use the Tags field, click inside the field and type a word or phrase. Sugar will recommend existing tags as you type, but you can choose to ignore the recommendations and create an entirely new tag. For more information about tagging records in Sugar, please refer to the Tags documentation in the Application guide.
    tags-field
  • Teams : The Teams field specifies which teams of users have access to view the record. An individual team selection works like a dropdown field which is described above. Click the Plus button to add additional teams to the record or the Minus button to remove a team. Click the Star button to set the primary team. For more information on teams, please refer to the Team Management documentation. 
    UI EditingFields Teams

Note: If your administrator has enabled team-based permissions, you may also see a Lock button or a "Selected" box on the Teams field. Please refer to the Using Team-Based Permissions section of this page for more information.

Using Team-Based Permissions

In Sugar, teams are typically used to control which groups of users can access a record. Using team-based permissions, however, an administrator may choose to extend the purpose of teams to control who can perform certain operations on the record (e.g. edit, delete). When enabled, regular users can use a record's Teams field to grant access such as viewing, editing, exporting, importing, and deleting permission to specific users or user groups.

An administrator must first enable team-based permissions and configure roles and users for this feature. For more information, please refer to the Role Management documentation. Once the roles are applied to users, any user who can edit the Teams field in the enabled module can grant extra access to teams of users.

If you are not an administrator and you are not sure if team-based permissions are enabled for a module, simply navigate to a record view, click "Edit", and look for a lock button next to the Teams field: 
lock buttons

If you do not see a lock button, reach out to your system's administrator to discuss whether team-based permissions are appropriate for your organization's business needs.

Note: Legacy interface modules also support team-based permissions but use a checkbox labeled "Selected" next to the Teams field to indicate whether or not the team's members have extra access to the record.

Team-based permissions have no effect on users who have not been assigned to roles that are configured with "Owner & Selected Teams" access. For more information, please refer to the Record Operation Definitions section of this page. For information on using team-based permissions on a record, please refer to the Role Management documentation.

To grant extra access to a record for all members of a team who have role permission, click the lock button next to the team's name. This will enable additional permissions according to the guidelines in the table below. To control an individual user's access to a record, add that user's private team to the record's Teams field and then enable or disable additional permissions according to the guidelines in the table below. Please note that extra access will only be granted to users who have a role restricting their access to "Owner & Selected Teams" as described in the Role Management documentation.

Team Setting Appearance Button Description
Additional Permissions Enabled A black button with an open lock enabled-lock Members of this team have extra access to this record or fields within the record as controlled by their roles
Additional Permissions Disabled A white button with a closed lock disabled-lock Members of this team have no additional team-based permissions as controlled by their roles

In the following example, members of team East have standard team access to the record (at a minimum, view permission), while Jim and members of team West have view permission plus extra access to do things such as working with restricted fields, and editing, deleting, and exporting the record. Note that a user can be an explicit or implicit member of a selected team, and if they are part of both a selected team and a non-selected team for a record, they will be granted the extra access. 
lock buttons

Note: Changes made to the selected state of teams on an existing record are audited in the record's change log.

Locked Fields

Occasionally, you may see a lock icon (not to be confused with the Lock Button used for team-based permissions) near one or more fields on a record in Sugar. The lock icon indicates that the adjacent field is temporarily locked from editing for all users. Locked fields occur as a result of Advanced Workflow settings that have been configured by your system's administrator. When a record becomes involved in a process that has locked fields, that record will respect those field locks until the record is no longer participating in the process.
711-rv-locked-alert

Locked fields are enforced in Sugar for imports, mass updates, and record merging. Please note that records containing one or more locked fields cannot be edited via list view regardless of whether the locked fields appear in the list view's columns. To edit the record's unlocked fields, you must navigate to the record view, which you can do by clicking on the record's link in the alert box or as you typically would in Sugar.
711-lv-locked-alert

Deleting Records

If a record is invalid or should no longer appear in your organization's instance, it may be deleted from either the record view or list view. Deleting via the record view allows you to delete the current record while the list view allows for deleting one or more records at a time. Deleting a record will not delete its related records and will only remove the relationship, so you may wish to also delete any related records to avoid orphaned records.

Please note that your ability to delete accounts in Sugar may be restricted by a role. For more information on roles, please refer to the Role Management documentation. Check with your system administrator if you do not see the Delete options.

Deleting via Record View

The following steps cover deleting an account via record view as an example:

  1. Navigate to an account's record view.
  2. Select "Delete" from the Actions menu. 
    UI RecordView Delete
  3. A pop-up message will display asking for confirmation. Click "Confirm" to proceed.

Deleting via List View

The following steps cover deleting an account via list view as an example:

  1. Navigate to the Accounts list view by clicking the Accounts module tab.
  2. Use the List View Search to find the Account record you wish to delete.
  3. Click the Record Actions Menu to the far right of the record's row and select "Delete". 
    UI ListView Delete
  4. A pop-up message will display asking for confirmation. Click "Confirm" to proceed.

Mass Deleting via List View

The following steps cover deleting one or more account records via the list view as an example:

  1. Navigate to the Accounts list view by clicking the Accounts module tab.
  2. Use the List View Search to find the Account records you wish to delete.
  3. Select the desired account records then choose "Delete" from the Actions menu.
    UI ListView MassDelete
  4. A pop-up message will display asking for confirmation. Click "Confirm" to proceed.

You can also use the Select All feature in the list view, which will allow you to easily select the first 1000 records in the result set. If you wish to delete more than 1000 records or delete a specific group of records on the list view, please use the filter option in list view search to perform the deletions in smaller batches.

Emailing Records

Sugar allows users to compose and send outbound emails to records which include an Email Address field such as accounts, contacts, leads, and targets as well as any custom person- or company-type modules which include an email address field. The sections below cover the various ways to send emails to records. Accountscontactsleads, and targets may also be emailed via campaigns, and more information about emailing these records via campaigns is located on their individual documentation pages.

Note: Before users can send email from Sugar, please complete the required configurations described in the Emails documentation. The logged-in user must have at least one outgoing email account successfully configured in the Emails module.

Once an email is successfully sent by a method other than workflows or campaigns, the email record will appear in the History dashlet and Emails subpanel on the record's record view. For more information on sending emails from your own account, please refer to the Emails documentation. 
UI EmailsSent EmailsSubpanel HistoryDashlet

Emailing via List View

For modules that include an Email field, the Email option in the list view's mass actions menu enables users to send an email message to one or more records at a time from the module's list view. Simply select the desired record(s) from the list view then choose "Email" from the list view Actions menu. The Compose Email window will open allowing you to enter in all relevant information (e.g. subject, body). Please note that the email will be sent to the selected record's primary email address on file.

The following steps cover composing and sending an email from the Accounts list view as an example:

  1. Navigate to the Accounts list view by clicking the Accounts module tab.
  2. Find and select the accounts in the list view that you would like to send an email to.
  3. Choose "Email" from the Mass Actions menu.
    UI ListView EmailOption
  4. In the Compose Email window, enter the subject and body of the email message, edit the recipient fields (optional), then click "Send".

After sending the message, the email record will appear in the Emails subpanel and History dashlet of each related record. 
Emails EmailsSubpanel HistoryDashlet SentEmail 7.7

Emailing via Quick Create

Quick Create provides an easy way to send an email from Sugar to the recipient associated with the record you are viewing. Quick Create for email messages can be accessed from the Quick Create menu on the navigation bar, from any Emails subpanel, or by clicking on a linked email address in Sugar list views or record views. 

  • Quick creating via Quick Create menu : Use "Compose Email" in the Quick Create menu to relate a message to the record you are currently viewing and automatically populate the message's "To" field with the record's name and primary email address. If you use the Compose Email quick-create option from any other page, simply insert the desired recipient(s) manually as explained in the Working With Recipient Fields section of the Emails documentation.
    711-qc-menu-emails
  • Quick creating via email address : The Quick Create view will also open if you click on a hyperlinked email address inside the Sugar application. For example, email addresses displayed in list views, dashlets, intelligence panes, and record views can be clicked to expose the Quick Create email compose view pre-filled with the clicked email address.
    • Quick create from an email address in list view: 
      710-QC-listview
    • Quick create from an email address on the record view: 
      710-QC-recordview
  • Quick creating via Emails subpanel : Click the Create (+) icon on the Emails subpanel to compose an email to the record's primary email address and automatically relate the message to the record you are viewing.  
    Note: Legacy modules contain an Activities subpanel instead of an Emails subpanel.
    711-qc-emailsubpanel

To edit or override a default email recipient on Quick Create, click on the name above the Subject field and the area will transform into the standard From/To/Cc/Bcc form.
711-edit-to-field

For more information on editing recipients, please refer to the Working With Recipient Fields section of the Emails documentation. 

Emailing via the Emails Module

Users can compose and send messages directly from the Emails module by clicking the Compose Email button on the Emails list view or by selecting "Compose Email" on the Emails module tab menu. This opens up the compose layout, which allows you to enter all of the relevant information for the email.

Use the following steps to compose an email via the Emails module:

  1. Click "Compose Email" on the Emails module list view or the Emails module tab menu:
    710-compose-email
  2. Enter appropriate values for the fields in the layout. All required fields are marked as such and must be completed prior to saving.
  3. Once the necessary information is entered, click "Send" to deliver the message to the recipients specified in the To, CC, and BCC fields. Alternatively, click "Save Draft" to navigate away from a message without sending it. Email records in a draft state are only visible to the email's assigned user and the administrator.

For more detailed information about sending emails, please refer to the Emails documentation.

Emailing via Workflows

Sugar's Workflows module is available to administrators and users with developer-type role access. With each workflow, a set of conditions triggers a combination of actions and email alerts, including the ability to send emails to Sugar records that include an email address. Workflows can send simple emails or can utilize alert email templates built to include relevant data pulled from the record as well as your organization's design and branding. For more information, please refer to the Workflow documentation.

Emailing via Advanced Workflow

Sugar's Advanced Workflow is available to administrators and users with developer-type role access. Process definitions created in Advanced Workflow may contain Send Message events that include the ability to send emails to Sugar records that have an email address. Send Message events utilize templates created in the Process Email Templates module. Templates may include relevant data pulled from the record as well as your organization's design and branding. For more information, please refer to the Process Email Templates documentation.

Note: Advanced Workflow (formerly Sugar Process Author) is exclusive to Enterprise and Ultimate editions of Sugar 7.6.x and later.

Exporting Records

Exporting downloads all fields for the selected records to your computer as a .CSV (comma-separated values) file. This may be useful when needing to use Sugar data with other software such as Microsoft Excel or to update existing records by exporting, making changes, then importing the altered records back into Sugar. For more information on updating existing records via import, please refer to the Import documentation. Due to PHP memory limitations on the server, there may be occasions when the application times out while exporting a large number of records. If you encounter an error when performing this action, we recommend selecting the records in smaller batches.

Records may be exported from the module's list view by first locating and selecting the checkboxes of the desired record. Then, select "Export" from the Mass Actions menu. You can also export Rows and Columns-type reports if you wish to employ more complex filter criteria and have greater control over which fields will be included. For more information on exporting records, please refer to the Export documentation.
UI ListView Export

Please note that your ability to export accounts from Sugar may be restricted by a role. For more information, please refer to the Role Management documentation. Check with your system administrator if you do not see the Export option.

Recalculating Calculated Values

Administrators or users or developer-level role access to a module may see an additional option in the list view's Actions menu: "Recalculate Values". This option appears only for modules that contain one or more calculated fields. For more information on calculated fields, please refer to the Studio documentation.

This utility allows administrators to recalculate affected field values following the addition or alteration of a calculated field in Studio. The mass actions menu option allows you to recalculate field values for up to 1000 records at a time. To update more than 1000 records, perform the recalculations in multiple batches as needed.

Note: This action will not appear unless the user is an administrator or has developer-level access to the module and there is at least one calculated value in that module. Please note that your ability to recalculate values may be restricted by a role. For more information on roles, please refer to the Role Management documentation. Check with your system administrator if you do not see the Recalculate Values option.

The following steps cover recalculating values for records from the Accounts list view as an example:

  1. Navigate to the Accounts list view by clicking the Accounts module tab.
  2. Use the list view's List View Search to identify accounts you wish to update.
  3. Select the desired accounts then choose "Recalculate Values" from the Actions menu.
    UI ListView RecalculateValues

Finding Duplicate Records

Between multiple users working in Sugar, importing new records, and converting leads, it is possible for duplicate records to be accidentally put into the system. Before creating a new record, the best practice is to first check that the record does not already exist in Sugar. You can identify duplicate records for cleanup using list view search from the module's list view.

Searching for records with similar names or other information can turn search into a powerful, duplicates-finding tool. A wizard is also available for finding potential duplicates and may be used as shown below. If duplicate records are detected, you can perform a merge per the Merging Records section of this documentation.

Please note that your ability to use the Find Duplicates action may be restricted by any role which prevents editing records. For more information on roles, please refer to the Role Management documentation. Check with your system administrator if you do not see the Find Duplicates option.

The following steps cover locating duplicate accounts using the Find Duplicates option from the Accounts record view as an example:

  1. Navigate to an account's record view.
  2. Choose "Find Duplicates" from the Actions menu. 
    UI RecordView ActionsMenu FindDuplicates
  3. Potential duplicate account records will be listed on the Find Duplicates page. Select the duplicate record(s) you wish to merge then click "Merge Duplicates".
    • You can preview the duplicate record's details by clicking the Preview button to the far right of the record's row.
    • You can search for specific records from the Accounts list view if you wish to check for more potential duplicates. For more information on performing a search, please refer to the List View Search section of this documentation.
    • You can also click the Gear icon above the Preview button to change the list of fields that display on the list view column headers.
    UI RecordView FindDuplicates Merge

Once you click "Merge Duplicates", the merging process with the current record will begin. For instructions on performing the merge that follows, please refer to Steps 3-9 of the Merging via List View section of this documentation.

Merging Records

When duplicate records are identified in Sugar, you have the option to merge two or more into a single record. Once the merge is complete, the duplicate record(s) will be deleted, and the primary record will remain. Please note that all relationships belonging to the duplicate records will be merged to the primary record meaning that any calls, meetings, cases, etc. related to the duplicate record(s) will automatically be related to the resulting, merged record. 
Note: Date Created, Date Modified, and Password field types are not supported when merging duplicate records in Sugar.

Merging via List View

List View Search may be used to identify duplicate records by, for example, searching for records with similar names. Once your search has identified duplicates, you can merge them directly from the module's list view.

The following steps cover merging accounts via the list view as an example:

  1. Use the list view's List View Search to identify duplicate accounts.
  2. Possible duplicates will be displayed in the list view. Select the duplicate record(s) that you wish to merge.
    • Please note that up to five records may be merged at once in Sugar. An error message ("Invalid number of records passed. The valid range is from 2 to 5 records.") will appear if more than five records are selected when attempting to perform a merge.
    merge-list-78
  3. Select "Merge" from the Actions menu to display the Merging Records page. The primary record's field values are displayed on the left while other record's values are in columns to the right. For convenience, fields with differing values will appear on the top of the list. Saving the merged records will preserve only the field values marked with the radio button into a single record. 
    UI ListView MergingRecordsPage
    If 3 or more records are selected to be merged, an X icon will appear at the top right of each record. Clicking the "X" will remove the record from the merge process but will not delete the record.
  4. To change which record is considered the primary, drag and drop the Primary label on the top of a different column.
  5. Review the field values in each column and click the radio button to the left of the value that should appear on the final record. You can also manually type or select a new value for any field as necessary.
    • Note: Fields you do not have Edit access for cannot be edited on the merging records page.
  6. Preview what the final, merged record will contain as you work by clicking the eye icon to display the preview in the Intelligence Pane.
  7. Click "Save" once all fields you wish to appear on the single, merged record have their radio buttons selected.
  8. A pop-up message will display confirming that the duplicate record(s) should be deleted. Click "Confirm" to proceed.

Viewing Record Historical Summaries

For modules that are related to activity records (e.g. calls, meetings, emails, notes, and tasks), you can view quick details of the related activities via a record's Historical Summary option. From the record view, simply select "Historical Summary" in the Actions menu.
UI RecordView ActionsMenu HistoricalSummary

The Historical Summary shows a digest of the following activity records that are considered closed by virtue of their statuses:

Record Type Included Statuses
Calls

Held, Canceled

Emails Sent, Received, Archived
Meetings Held, Canceled 
Notes All notes
Tasks Completed, Deferred

Note: Calls and meetings with a Canceled status will display a status of "Not Held" in the Historical Summary.

The Historical Summary page will display as a list view with each activity's type, subject, status, description, etc. and allow you to click the activity's name to view its full details. You can add additional fields by clicking the Column Selection icon to the far right of the list view column headers. You can also preview the activity record in the intelligence pane by clicking the Preview icon to the far right of each record's row, providing key information as well as any activity stream information. For more information on activity streams, please refer to the Activity Streams documentation.

The Historical Summary list view provides the ability to reorder columns by dragging and dropping the title of the column to the desired location. The new column order will remain for a user upon subsequent visits to the module until the user's browser cache is cleared. You can reset the column order to the default view by clicking the Gear icon to the far right of the list view column headers and selecting "Reset default view". Please note that this option only appears if the current list view column order is different from the system's default column order.

Users can also easily adjust the size of columns in the Historical Summary list view per their viewing preference. Simply place your cursor on the column divider, and when the Left-and-Right arrow appears, click and drag the column to the desired size. The set column width will be preserved when you navigate away from the page. Sugar will render the preferred column size across sessions until the user removes or resets the relevant browser cookies. You can reset the column width to the default size by clicking the Gear icon to the far right of the list view column headers and selecting "Reset default widths". Please note that this option only appears if at least one of the column widths in the Historical Summary list view is different from the default column width.
UI RecordView HistoricalSummaryPage

Viewing Record Change Logs

Changes made to each record are tracked over time, and users are able to view the history of changes via the change log in each record's record view. To view the change log, navigate to a record view and select "View Change Log" from the Actions menu. Please note that only fields marked as "Audit" in Admin > Studio will be displayed in the change log. For more information on designating for audit, please refer to the Studio documentation.
UI RecordView ActionsMenu ViewChangeLog

Once the change log opens, you can view the details of historical changes and can search by field name, old value, etc. by entering the keyword into the search box.
UI RecordView ViewChangeLogPage

Record PDFs

If you require a record's information outside of Sugar, you can download or email the information in PDF form. Administrators have the ability to build multiple PDF templates via Admin > PDF Manager for each module to ensure that the relevant record information is being included for your specific purpose. For more information on creating and managing PDF templates, please refer to the PDF Manager documentation. Please note that the Download PDF and Email PDF options will only appear in the Actions menu if there is an existing PDF template available for the module.

Note: If a user's email address is empty in their profile or if they have set their email client to "External Email Client", then the "Email PDF" option will be hidden for that user.

Downloading Record PDFs

Download record information as a PDF file via the desired record's record view by selecting "Download PDF" from the Actions menu. All PDF templates which your administrator has created and made available for the module will appear beneath the Download PDF option. Simply select one of the templates to generate the PDF file to view or save onto your local machine. 
UI RecordView DownloadPDF

Emailing Record PDFs

Users also have the option to email record information as a PDF file using Sugar's email client. From the originating record's record view, click the Actions menu and select "Email PDF". All of the PDF templates that your administrator has created and made available for the module will appear beneath the Email PDF option in the Actions menu. 
UI RecordView EmailPDF

Select one of the templates to create a draft in the Emails module. Sugar will deliver you to the record view for the email.710-emailquote

The draft will have the following information pre-populated:

  • From : The logged-in user's outgoing default email account
  • Date : The date the message is being sent
  • To : The primary email address of the originating record (if available)
  • Subject : The name of the originating record
  • Body : "Here is the file you requested (You can change this text)"
  • Attachment : The PDF file created from the originating record
    • The file's name will appear as "Email Attachment : {originating_record_name}_{template_name}.pdf"; for example, "Email Attachment : Acme_25_units_Customer_invoice.pdf".
  • Teams : The logged-in user's default team(s)
  • Assigned To : The Sugar user assigned to the email record
  • Related To : The originating record and its module

Click "Edit" on the draft email record to reveal the Send button or to update the fields as necessary and then click "Send". For more information on sending emails via the Emails module, please refer to the Emails documentation.

Favoriting Records

Each Sugar user has the option to designate their own favorite records which are important or will be viewed often so that they can easily be accessed via list view search or from the module tab. Once records are marked as favorites, select "My Favorites" from the Filter option next to the Search bar or select from your most recent favorites directly from the module tab.

Favoriting via List View

The following steps cover marking records as favorites via the Accounts list view as an example:

  1. Navigate to the Accounts list view by clicking the Accounts module tab.
  2. Use the List View Search to find the account records you wish to mark as favorites.
  3. Darken the star icon on the left of each desired account's row by clicking on the star one time.
    favorite78
  4. To remove the account as a favorite, click the star again to revert it to white. 

Favoriting via Record View

The following steps cover marking records as favorites via the Accounts record view as an example:

  1. Navigate to an account's record view.
  2. Click the star icon to the right of the account's name in the upper left of the record view to designate it as a favorite.
  3. To remove the account as a favorite, click the star again to revert it to white. 
    favorite-recordview78

Favoriting via Subpanel

The following steps cover marking account records as favorites via the subpanel in related modules as an example:

  1. Navigate to a related module's record view.
  2. Click the star icon to the left of the desired record's row in the Contacts subpanel. 
    Accounts FavoritingSubpanel7.7
  3. To remove the contact as a favorite, click the star again to revert it to white.

Following Records

Users can also choose to follow individual records. This allows each user to personalize their activity stream by specifying which records' posts should appear on the activity streams displayed on their Home page and in module list views. Please note that you will automatically follow records that you create as well as records that are assigned to you. You will not, however, automatically follow records you import. Should a user lose access to a record in Sugar, they will automatically stop following that record. For more information about activity streams, please refer to the Activity Streams documentation.

Following via List View

The following steps cover marking an account to follow via the Accounts list view as an example:

  1. Navigate to the Accounts list view by clicking the Accounts module tab.
  2. Use the List View Search to find the Account records you wish to follow.
  3. Click the Record Actions menu to the far right of the records row and select "Follow".
    follow-list78
  4. To stop following the account, click the Record Actions menu and select "Unfollow".

Following via Record View

The following steps cover marking an account to follow via the account's record view as an example:

  1. Navigate to an account's record view.
  2. Click on the Follow button to the right of the account's name to change its label to "Following". 
    follow-list78
  3. To unfollow the account, click on the Following button to revert its label to "Follow". 
    following-record78-2

Sharing Records

Individual records can be shared with other users in your organization by sending an email including the record's direct link. In the desired record's record view, select "Share" from the Actions menu. A Compose Email window will open, and the email's text will include the URL of the record. Enter the recipient(s) email address in the To field then click "Send".
UI RecordView ActionsMenu Share

The recipient can simply click the link in the email to access the account record in Sugar. Please note that the user must be logged into Sugar in order to access the record. Users will only be able to view the shared record as allowed by their team membership, user access type, and assigned roles. For more information on teams and roles, please refer to the Team Management and Role Management documentation.

Using the TinyMCE Text Editor

TinyMCE is a third-party WYSIWYG editing tool used by Sugar so that users can create content such as knowledge base articles and email messages with rich-text formatting elements.

TinyMCE's rich-text editor framework presents the following familiar formatting options:

Element Button(s) Function
Source Code KB7.7 EditHTML Bypass the rich-text editor options and insert your own HTML code or view the HTML code of an existing template to make advanced changes.

Note: Sugar uses TinyMCE 4.x for Sidecar modules. By default, this version supports HTML5 schema elements and will strip any HTML formatting elements that do not adhere to these specifications. 
Bold, Italic, Underline, Strikethrough KB7.7 StyleIcons Use these basic font formatting options to easily add common styles to text in the message body.
Bullet List, Numbered List KB7.7 Lists Transform paragraphs in the message body into a formatted list.
Align Left, Align Center, Align Right, Justify KB7.7 Align Set paragraph alignment.
Text Color, Background Color KB7.7 ColorOptions Choose a custom font color or highlight text with a background font color.

Clear Formatting

UI TinyMCE ClearFormatting Clear any formatting.
Insert/Edit Image, Insert/Edit Link KB7.7 InsertImage Insert or edit an image or a link.
Font Sizes KB7.7 FontSize2 Choose a font size for the text.

Paragraph

UI TinyMCE Paragraph Choose a format for headers.

Last modified: 2018-04-30 04:51pm