User settings are utilized in order for users to make changes to their account to fit their preferences and needs. The changes that are made to user settings do not affect any other users of an Insightly CRM account.
In this Article
How do User Settings Work?
User settings can be accessed by all users and used to personalize a user's account. To access user settings, click the user profile in the upper right of Insightly CRM and select User Settings from the available options.
User Settings is separated into several sections for ease of access and organization. Details for each section of User Settings can be reviewed below; the changes that are made to an individual users settings do not affect any other users of an Insightly CRM account.
The User Details section of User Settings allows users to set their details such as name and applicable notes as well as their preferences for the following:
- User Details: Users can edit details regarding their name and applicable notes.
- Language Settings: Insightly allows users to create custom fields, tags, and categories in the event that their company has a mix of employees who speak different languages. A best practice is to make these texts bilingual; for example, if a category named Meetings for tasks is created, an English/Spanish version of this category would be Meeting/Reunión.
- Regional Settings:
- Time Zone: Each user can select their own regional settings for their geographical location to allow for calendar events to display in the correct time zone when viewed by other Insightly users in different time zones. For users utilizing Calendar Sync to display Insightly items on their Google calendar, ensure that the Google time zone settings match the time zone set in Insightly CRM.
- Date Settings:
- Time Settings:
- Time Format: Once a selection has been made, an example of the format will be displayed below this field.
- Number Format: This field cannot be edited manually and can only be changed by the selection made in the Date Time Culture field.
By connecting an email account to Insightly, users can utilize email functionality without leaving Insightly CRM. Insightly provides integration with Gmail, Office 365 Outlook, Outlook.com (including Hotmail accounts), and SMTP servers such as Microsoft Exchange.
- If email aliases have been setup on an email account, these are not accessible from Insightly.
- If an SMTP connection is being setup, work with the email administrator to obtain the correct login information.
- As a best practice, users should review whether their email provider has sending limits for their account as some providers only allow a limited number of emails to be sent per day or per hour.
If errors are encountered with adding an email account, please review the email account connection troubleshooting article.
Email Account Connection
- To connect an email account to Insightly, navigate to User Settings > Email Accounts.
- Select the appropriate email provider from the list in the Add Email Accounts section. Users can select Gmail, Office 365,Outlook.com, or Other.
- Follow the prompts to connect to the email account and click Add Account to complete the connection.
- Some email applications such as Outlook.com will send an email asking the user to sign in to confirm the connection. Once the confirmation is complete, users can return to Insightly and choose the email provider again which will complete the verification.
- If edits need to be made to an account connection (for example, if the user's email login credentials change with the email provider), users will need to delete the connected account from Insightly and follow these instructions to add it again.
- Microsoft Exchange (Office 365) users will need to enter the email address or domain/username (depending on user configuration) and the Microsoft Exchange password and click the Auto Discover button.
- If the Exchange server is not found, the EWS Endpoint URL will need to be entered (the Exchange Administrator can provide this information).
- The URL is typically in the format of https://ews/exchange.asmx; Office 365 users can try the server address of https://outlook.office365.com/EWS/Exchange.asmx (the URL can be entered into a browser to test validity). VPN, firewall, or other security restrictions may block Insightly from connecting to a server.
- If the Exchange server is not found, the EWS Endpoint URL will need to be entered (the Exchange Administrator can provide this information).
Reconfiguring Microsoft Authentication
Office 365 users who have setup an Office 365 email account for sending emails out through Insightly or to utilize Calendar Sync prior to October 1st, 2022 will be required to reconfigure authentication due to Microsoft’s migration from their previous basic authentication process to OAuth.
- Navigate to User Settings > Email Accounts.
- Delete all Office 365 accounts that have been configured by clicking the trash can icon to the right of each account.
- A warning message will appear at the top center of the screen: Are You Sure You Want To Delete This Email Account? Click OK.
- Follow the instructions in the Email Account Connection section to reimplement any accounts that were removed in this process.
SMTP is a protocol used for sending email; users who are not familiar with the process of SMTP should ask for assistance from their email provider. If information for POP or IMAP protocols are entered they will not work as they are used for retrieving messages.
- For SMTP connections, navigate to User Settings > Email Accounts.
- Select Other from the list in the Add Email Accounts section.
- Users will be prompted to enter their port number and login information. When all details have been entered, click Add Account.
- Insightly will send a verification email and the new account will appear in the Email Accounts list.
- If a verification email is not received, delete the SMTP connection and then add it again.
Customizing an email signature can help reduce the chance of emails ending up in recipient's spam folders when sending an email from Insightly CRM. Email signatures can contain up to 500 characters; it is a best practice to include name, company name, title, and phone number.
- To customize an email signature, navigate to User Settings > Email Signature.
- Via the text box in the Email Signature section, design the email signature as it should appear to recipients; the text editor toolbar can be utilize for formatting options and an image can be added as well.
- When the design of the email signature is complete, click Save Email Signature and the signature will automatically be included when sending emails from Insightly CRM.
Add an Image to an Email Signature
Image files that are saved to an image hosting service or a user's own server (if publicly accessible) can be added to email signatures within Insightly CRM. Images cannot be directly uploaded to Insightly CRM.
- To add an image to an email signature, navigate to User Settings > Email Signature.
- Via the text editor toolbar in the Email Signature section, click the HTML option.
- Within the HTML code, locate where the image should appear. Utilizing the HTML img tag, paste the URL for the image.
Image URL: http://your.image.url/folder/filename.jpg
HTML Code: <img src="http://your.image.url/folder/filename.jpg">
- When the image URL has been added to the HTML code, click the HTML button in the text editor toolbar again to return to the email signature and save the addition of the image.
- The image that was added will display where it was added in the HTML.
Users can locate their Insightly mailbox address by navigating to User Settings > Mailbox.
Each user has an Insightly CRM mailbox that is unique. This mailbox address is not an email inbox or a mail application (e.g. Gmail, Yahoo, etc.) where emails can be sent and/or received. The Insightly CRM mailbox is an email address that can be included on emails and will allow Insightly to automatically scan the email addresses and domains and automatically link the message to matching contacts and organizations. If Insightly CRM does not find matching records, new records for contacts and organizations will be automatically created.
- Users can create a contact in their email providers contact list for their Insightly mailbox address and title it as "My Insightly Mailbox" for example. This allows users to CC, BCC, or forward an email to this address easily without having to copy and paste the mailbox address from Insightly CRM for each use.
How Insightly CRM Links Email Messages
Insightly only supports email headers in English, therefore, they must read To, From, CC, BCC; if a different language is utilized, Insightly may not recognize the fields and will be unable to complete linking the email to the proper records. Insightly expects the first several lines of an email body to look similar to the example below:
Adding an Insightly mailbox address in the To, CC, and BCC fields yields different results:
When an email is received that needs to be saved to Insightly CRM, it can be forwarded to a users Insightly mailbox address via the To field. When the email is received, Insightly will scan the first 10 lines of the email body for email addresses and domains in the original message header. Insightly will not link the email to other addressed in the To, CC, or BCC fields.
When sending an email that needs to be saved to Insightly CRM, enter the Insightly mailbox address in the CC field. When the email is received, Insightly will review the To field for email addresses and domains and save the email to the corresponding record(s). Insightly can also scan the CC field if this functionality is enabled via User Settings > User Settings.
If a mailbox address for an Insightly opportunity or project is added to the CC field, Insightly will link the email to the corresponding opportunity or project record as well as any related contacts or organizations. Because of this, it is a best practice for users to not use both the opportunity or the project mailbox address and a personal mailbox address - use one or the other.
If an Insightly mailbox address is added to the BCC field of an outgoing email, Insightly may not be able to scan and link the email to the correct record. When the BCC field is used, linking is dependent on the email provider and email application being used to send the email. Due to some email providers and applications not exposing enough information in the email body, this can affect proper linking. If proper linking is not occurring when utilizing the BCC field, resort to using the CC field instead.
The User Settings section of User Settings allows users to define settings for functionality such as emails, tasks, calendars, APIs, etc.
- Email Address Links in Insightly:
- Include My Insightly Mailbox Address in the BCC Field: Enabling this setting will automatically insert a users Insightly mailbox address to the BCC field when an email is initiated from Insightly CRM
- Email Mailbox Settings:
- Make my Emails Visible to Others by Default: Enabling this setting will allow all emails saved to Insightly visible to all other users of an Insightly CRM account.
- Automatically Add and Link Contacts Included in the Email CC Field: Enabling this setting will allow Insightly to scan the CC field for email addresses and automatically link the email to corresponding contacts within Insightly CRM.
- Connected Application Settings:
- For Google integrations such as Contact Sync and/or Calendar Sync, Google will occasionally update how third party applications (such as Insightly) can access user data through Google APIs. When these updates occur, if users experience an error regarding issues authorizing with Google, the Google API key in this section can be disabled and then reactivated.
API Key and URL
A user's API key and API URL can be located via navigating to User Settings > User Settings and reviewing the API section.
Once an API key has been shared, access can be revoked by clicking Generate New API Key; changing a user's administration permissions will also reset their API key. Once a new API key has been generated, users must update any applications with the new key in order for them to maintain access to Insightly data.
Notifications are alerts that Insightly sends to a user via email. Notification settings allow users to have control over which notifications are received and which records are automatically or manually followed; in order to receive a notification for a record, users must be following the record. For calendars triggering Google notifications, users can review their Google calendar notification settings.
Notifications can be accessed via User Settings > Notifications or by clicking the bell icon in the upper right of Insightly CRM and clicking My Notification Settings at the bottom of the expanded list.
- Reminders: Define whether a notification is initiated to the logged in user when a task reminder becomes available.
- New Assignments: Define what items initiate a notification to the logged in user when a new item is assigned to them.
- Changes to Followed Records: Define what changes to following records initiate a notification to the logged in user following the record.
- Queue Records: Define whether a notification is initiated to the logged in user when a new item is added to their queue.
- Email: Define whether a notification is initiated to the logged in user when an email is opened/clicked.
Enabling Desktop Notifications
Once users have selected what items they required notifications for, the next time a notification is triggered the browser will ask for permission to allow the notifications. Allow should be clicked and notifications will then appear in the upper right of the user's primary monitor.
If Block is clicked, notifications can be allowed at a later date by accessing the site settings and allowing Insightly to send notifications.
Users can define settings that will automatically activate the following of an item that has been created, updated, or assigned. In contrast to the auto follow settings, users can also manually follow items. To define how and when notifications for followed items are received, users can review the Notifications section of User Settings.
Users can define what Insightly CRM items will be followed automatically by navigating to User Settings > Following. Various notifications can be enabled for records modified by a user, assigned to a user, or records that the logged in user assigns to others.
- Records I Modify: Automatically follow records that the logged in under creates, updates, or comments on.
- Records Assigned to Me: Automatically follow records that the logged in user is responsible for to receive notifications when another user updates or changes the record.
- Records I Assign to Others: Automatically follow records that the signed in user has assigned to another user in order to stay up to date on progress.
To view a list of items being followed, View Items I'm Following can be clicked via User Settings > Following or by clicking the bell icon in the upper right of Insightly CRM and clicking Items I'm Following.
User can manually following records of their choice my accessing the record and clicking the star icon to the right of the record name. A yellow star indicates that the logged in user is following a record.
To view a list of items being following, users can navigate to User Settings > Following and click View Items I'm Following or click the bell icon in the upper right of Insightly CRM and click Items I'm Following.
In order for users to enable Google Contact Sync, System Administrators will be required to enable this functionality for their Insightly CRM account by navigating to System Settings > Feature Settings > Google Contact Sync.
Google Contacts Sync is an Insightly feature that syncs all Insightly contacts and contact updates to a users Google Contacts list. Users are not required to have an Insightly for G Suite account to be able to use this functionality as it is available for any Gmail account for users who have an Insightly paid plan.
- This is a one way sync to Google, therefore changes in Google Contacts will not be synced to Insightly. Once synced, Insightly recognizes when a change is made to an Insightly contact and will update the corresponding Google contact.
- Each Insightly contact that a user has access to (except for Insightly users) will be synced to Google Contacts.
- Once enabled, contacts will be queued for syncing. Insightly customer data is synced on a first come, first serve basis. When the sync begins, the page will display a sync progress and the number of contacts synced.
- Once synced, Insightly CRM contacts will appear in a Google Contacts group titled Insightly Contacts and they can optionally be added to the Google Contacts My Contacts group as well.
- When deleing a contact from Insightly, it will also be deleted from Google Contacts for any user who has the contact synced.
- If a Google account reaches the limits set by Google Contacts, Insightly will be unable to copy additional contacts to Google and the contact sync will be disabled automatically.
Once contact sync is enabled, users can learn about disabling it via the Disabling Google Integrations article.
- To enable Google Contact Sync, navigate to User Settings > Contact Sync.
- If a user's Insightly account is not connected to Google, click the Setup Google Integration link to allow Insightly access to the Google Contacts list. Only click Allow after confirming that the browser is logged into the correct Google account; if the wrong account is connected, users can view and remove connected applications from their Google account security settings.
- Select On to enable Google Contact Sync. If contacts in Insightly already exist in Google Contacts, they will be duplicated on the Google side; synced contacts will appear in the Insightly Contacts group in Google Contacts but preexisting Google contacts will not.
- If synced Insightly contacts should be added to the My Contacts group in Google, enable the Add Contacts to your Google "My Contact" Group checkbox. Many mobile devices and applications pick up contacts only from the My Contacts group in Google therefore enabling this setting can ensure all appropriate contacts are gathered by mobile devices and applications.
After the initial sync occurs, users can resync if necessary by clicking Resynch all Contacts Now. This will delete all contacts previously synced (even if they are also in the My Contacts group) and Insightly will perform a new sync and all contacts will be synced to the Insightly Contacts group (as well as the My Contacts group if Add Contacts to your Google "My Contact" Group is enabled).
- For Google integrations such as Contact Sync and/or Calendar Sync, Google will occasionally update how third party applications (such as Insightly) can access user data through Google APIs. When these updates occur, if users experience an error regarding issues authorizing with Google, the Google API key via User Settings > User Settings > Connected Applications can be disabled and then reactivated. Users will then be required to re-enable Contact Sync.
Calendar sync is a feature of all paid plans that allows users to sync their Insightly calendar with Google Calendar or Microsoft Exchange calendars (including many Outlook installations). By syncing with Insightly, any events added, edited, or deleted in one calendar will be instantly updated in the other (synced items from an external calendar cannot be edited within Insightly). After connecting to an external calendar, users will see their Google or Exchange calendar items on their Insightly calendar and vice versa.
- This feature can be used with any Insightly and Gmail/G Suite account; a connection from G Suite to Insightly isn't required.
Users can define whether to sync Insightly milestones and tasks as well; when enabled, Insightly will add two new calendars to the user's external calendars named Insightly Tasks and Insightly Milestones (tasks require a due date in order to be displayed on a calendar). Tasks and milestones cannot be edited from an external calendar - edits to these items can only occur from Insightly.
- Exchange calendar sync is supported for Microsoft Office 365 and Microsoft Exchange Server 2013 and above.
- Insightly will sync to and from a user's default calendar; custom calendars will not be synced with Insightly.
- Free email services with domains such as yahoo.com or hotmail.com cannot be used with the Exchange calendar sync.
Once calendar sync is enabled, users can learn about disabling it via the Disabling Google Integrations article.
To enable calendar sync, navigate to User Settings > Calendar Sync and select a calendar to sync with from the drop-down menu. Users can select Do Not Sync, Google, or Exchange.
Once a calendar is selected, the option to sync Insightly tasks and milestones is available to enable as desired.
If a user's Insightly account is not connected to the necessary calendar provider, click the Setup Google Integration or Setup Microsoft Exchange link as applicable to allow Insightly access to the Calendar.
Google: Only click Allow after confirming that the browser is logged into the correct Google account; if the wrong account is connected, users can view and remove connected applications from their Google account security settings.
Exchange: When setting up a connection to Microsoft Exchange, clicking the setup link will cause the Exchange Settings section to appear on the page. Enter the user’s Exchange email address and click Add Office 365 Account. Once the Exchange account has been authenticated, a message of Exchange Settings Saved will appear.
Click Save Calendar Sync Settings to save the changes; the initial sync will take a few moments to complete.
For Google integrations such as Calendar Sync and/or Contact Sync, Google will occasionally update how third party applications (such as Insightly) can access user data through Google APIs. When these updates occur, if users experience an error regarding issues authorizing with Google, the Google API key via User Settings > User Settings > Connected Applications can be disabled and then reactivated. Users will then be required to re-enable Calendar Sync.
Office 365 users who have setup an Office 365 email account for sending emails out through Insightly or to utilize Calendar Sync prior to October 1st, 2022 will be required to reconfigure authentication due to Microsoft’s migration from their previous basic authentication process to OAuth. The Reconfiguring Microsoft Authentication section above can be utilized by users affected by this change.