Call Us: +44 (0)1748 473000

Call Us Facebook Twitter Pinterest Linked in Instagram Youtube GooglePlus

Find out how to get 2 hours free training by referring a friend? 
What's the catch?
Articles Categories Screencasts

Troubleshooting the Outlook Add-in. How do I Install - I am having problems installing - I receive error messages when installing the Outlook Addin?

Updated: 24 January 2017 09:15:24 OpenCRM::Add-in::Outlook

The below are guides to some of the most common issues people have when using or installing the Outlook Add-in


What versions of Windows / Office do you support for the OpenCRM Outlook Add-in?

The Outlook add-in is supported on any version of Office/Outlook from 2003 up to Outlook/Office 2013 (32 bit) and Windows XP up to Windows 7 (64 or 32 bit).

It should also work on Windows 8 but due to the infancy of the operating system we have come across some issues here.

Due to changes in components shipped with Office 2013, some manual intervention may be required following the standard setup process. Contact the OpenCRM support team for assistance in this instance.

Installation of the Outlook Add-in on Virtual machines and Parallels for Mac should work, but is not officially supported.

We do not support 64bit Office of any version.



Associate with OpenCRM doesn't auto-search for Contact and after conversion subject and dates are blank

You need to upgrade the Outlook Add-in to the latest version:


 When I copy and paste an email address from Outlook into OpenCRM my emails dont send, why is this?

Generally when you copy an email address from Outlook (right click - copy address) and you paste this into any data field you might notice that this copies more information than just the email address, it often copies ;

Persons Name < >

It is this format that will cause problems when you try to email from OpenCRM.

Note : When you save the record the email address will show correctly as the screen display code automatically displays the correct format and removes everything before the < bracket and everything after the > character.

The answer is to first of all check to see if the format of the email address is as above and if it is then edit the record and remove everything but the conventional format ;


Outlook Add-in - Login issue - You must specify a valid username and password - error.

One of the things that can cause a problem when you login to OpenCRM from the Outlook Add-in is you will receive an error saying "You must specify a valid username and password".

This can be caused by not having the correct username and password entered into the add-in login screen, however, one thing to bear in mind is that attempts to login from any location, including the Outlook Add-in, can trip the security checks within OpenCRM. If you enter the wrong password into the Outlook Addin login box you could LOCK your account. The same error message is returned regardless of the wrong username / password combination OR having your account LOCKED.

You should check that you are able to login to your account using the normally Web Based method to be sure that your account is accessible. Should you lock your account you will need to speak to an Administrator so that they can unlock your account.


I have a problem with the synchronisation of Contacts / Calendar in the Outlook Add-in and I want to reset the sync

Providing all of your Outlook contact data has been stored in OpenCRM, the best and simplest thing to do is to bring all of the data back down from OpenCRM. To do this, you need to do the following:

  • Back up your Contacts, Calendar and Task items using Outlooks Import/Export feature (normally located under the FILE menu).
  • Delete all Contacts / Calendar Items / Tasks from Outlook (in the folders which are set to synch with OpenCRM).
  • Navigate to the folder where the Outlook Add-in is installed - this will normally be C:/program files/opencrmoladdin/
  • Find the files OLData.xml, vtigerdata.xml, opencrmdata.xml and mapvtigerol.xml in the datausername folder under the install directory of the outlook add-in and delete them.
  • Run a new synchronisation. Without the XML file, the add-in has no knowledge of any previously synchronised data, and as the folders to synch into are empty, it will simply re-populate them with everything from OpenCRM.


How do I prevent my email client from leaving copies of messages on the server? How do I configure my email client to delete downloaded emails from the server? I am unable to receive emails and senders are getting bounce backs / rejection emails saying that my mailbox is over quota what should I do?

If using Outlook Express or Windows Mail or Live Mail:

Go to Tools then 'Account's, select your email account and click 'Properties' and then 'Advanced', under 'Delivery' ensure 'Leave a copy of messages on the server' is unchecked and click 'OK'

If using Outlook:

Go to 'Tools', then 'Account Settings', select the email account and click 'Change' then click 'More Settings' then click the 'Advanced' tab, under 'Delivery' ensure 'Leave a copy of messages on the server' is unchecked and click 'OK', 'Next' and then 'Finish'


Error "System Files are out of date" when trying to install the Outlook Add-in.

Setup cannot continue because some system files are out of date on your system. Click OK if you would like setup to update these files for you now. You will need to restart Windows before you can run setup again. Click cancel to exit setup without updating system files.Setup cannot continue because some system files are out of date on your system. Click OK if you would like setup to update these files for you now. You will need to restart Windows before you can run setup again. Click cancel to exit setup without updating system files.

If you receive the above error message when trying to install the Outlook add-in, you can try the following to correct this. If you are not comfortable with this procedure, please contact the OpenCRM support team.

In the files received with the installation package, is a file called SETUP.LST.

1. Right click this file and choose "Open With" and then "Notepad"

2. Remove the following line from underneath the heading "[Setup1 Files]"

   File18=@wininet.dll,$(WinSysPath),$(DLLSelfRegister),$(Shared),4/26/13 1:10:13 PM,1766912,10.0.9200.16540

3. And rename the final line under this heading accordingly:

   File19=@opencrmdll.dll,$(AppPath),$(DLLSelfRegister),,4/26/13 11:02:34 PM,368640,

   File18=@opencrmdll.dll,$(AppPath),$(DLLSelfRegister),,4/26/13 11:02:34 PM,368640,

4. This should allow you to run the install file. You may receive a number of errors during the install process. Click "ignore" on each of these errors. The setup should then complete and the add-in should be visible and working in Outlook.


I am trying to install the Outlook add-in and get this message, what does it mean?: Outlook Add-in - Error while initialising log file

This message means that the add-in is unable to access the folder which contains its log files. This is almost always due to permissions on the required folder, or restrictive permissions on the PC or local user account.

There are a number of possible fixes to this issue:

1. Install the Add-in to a directory you have full permission on - a good example here would be the "My Documents" folder (c:/users/username/Documents in Windows Vista onwards)

2. If that doesn't work - or alternatively - ensure that the user which you are logged in as has full system administrator privileges ON THE LOCAL PC ACCOUNT (i.e. not just the domain account). Install and log in for the first time using this account. Following this, admin access can be revoked.

3. If all the above fails, you can follow these instructions to allow the add-in to write it's log files to it's installation directory.

  • Go to the Start menu and select Computer / My Computer

  • Browse to the Outlook Addin install directory this will normally be C:\Program Files\opencrmoladdin

  • Right click on the opencrmoladdin folder and select "Properties"

  • Select the "Security" tab

  • Click the "Edit" link

  • Click "Add"

  • Enter "Everyone" in the "Enter the object names to select" box and click OK

  • Select the newly added Everyone Group, tick "Full Control" and click OK

  • Click OK to close the Properties window
  • Reload Outlook and follow the instructions here to Login

Can I stop the Outlook Security Warning from popping when I use the Outlook Addin?

Outlook has a feature that allows you to be warned whenever any suspicious activity is detected.

This pop up warns you about malicious code being run on your emails, the Security warning pop up helps to stop this malicious access and gives you control to allow/disallow if the process should be carried out.

Although very helpful these warnings can be irritating if you have a third party application that needs to access the information in Outlook, such as the OpenCRM Outlook Add-in.

There are a number of options available to you......

1. Just accept that the warnings are there for your own good and click to allow access whenever they appear.

2. Add a third party add-on for Outlook that will control the pop ups - some of these add-ons have a level of programmatic control available and therefore can be intelligent, letting certain process access information without the warning whilst retaining a level of security.

3. Manage the Security warnings - so that they only appear when your Anti Virus software is not up to date or compromised. (Depends on the Operating System version).

4. Manage Security warnings - to supress them at all times

Managing Security Warnings

If you would like to manage the way that Security Warnings are displayed you should follow these steps;

(Example is for Outlook 2013)

Select - FILE > Options > Trust Center > Trust Center Settings > Programmatic Access

You can select to display the Security Warnings whenever your Anti Virus software is inactive or out of date - this is generally the default and the preferred method.

Note : This relies on Outlook being able to detect your Anti Virus software - some Windows environments, such as Remote Desktop and Terminal Services session do not support this feature.

You can set Outlook to always warn you of any suspicious activity OR you can turn off the Security warnings completely.

Note : Turning off the Security warnings is not advised - if you do decide that this is the setting that suits you best, make sure that you have suitable Anti Virus software and Malware protection in place.

If you set these options to Never warn me.... you will no longer receive the security pop ups.

Rate This Article
  • 1 star
  • 2 star
  • 3 star
  • 4 star
  • 5 star
Feedback and Comments
captcha code  

You may also be interested in:


Twitter Feed


Software Add-ons Ltd
1 Battalion Court
Colburn Business Park
North Yorkshire
United Kingdom
+44 (0)1748 473000
+44 (0)870 125 5962
Reg #:
England & Wales 05387424

marker Find on Google Maps


OpenCRM Campaigns vs …

A little while ago now, we had a customer with a very specific reason for wanting to use MailChimp instead of relying solely the bulk emailing and Campaigns module in OpenCRM. This was all down to the way they managed some, but not all of the elements of their marketing strategy. Long story short, we developed a MailChimp integration as part of this implementation. As it was an integration we could see being useful to other customers, we decided to release it...

Let Your Employees Ru…

Each different industry and the players within that field face their own challenges when it comes to the successful running of their business, but the basic goals will generally be along similar lines - business expansion, growing profits, customer retention and keeping employees happy. A key part of that staff satisfaction is empowerment. Brands all over are doing their best to empower their customers by inviting them to complete customer surveys and take part in competitions. By inviting them to...

The Cloud is Just Bet…

I’m always amazed when I speak to people who would rather keep their data in a onsite server in their office rather than the Cloud. I spoke to someone just this past weekend who was convinced that it was safer because they could see and touch that server in the back room of the office. They knew where it was and what it was doing…or at least knew that it wasn’t physically going anywhere. And I can understand the peace of mind...

Productivity is Drive…

Productivity has always been one of those things that I feel strongly about when it comes to running a business. Now you talk about giving people the right tools and finding the right job role for them all day long, but the one thing that never fails to increase a team’s productivity in my experience comes down to processes. Let me give you an example. Several years ago we had a little problem here at OpenCRM. Our sales team and our projects team...

Protect Yourself agai…

As currencies fluctuate, make sure the Value of your Quotes and Sales Orders don’t. I was listening to a conversation on BBC Breakfast the other morning when something caught my ear: No one is quite sure what the impact of Brexit will be on the strength of the pound. This can create some uncertainty when generating Quotes if you operate using a number of different currencies. Lots of systems, including OpenCRM, have the ability to integrate with an Online Currency Exchange, giving...

Find the Right Approa…

It’s not terribly surprising that a recent study presented to the British Psychological Society by John Hackston found that some people found receiving, replying, and managing their email inbox more stressful than others. The author suggested that different personality types will need to structure the way they approach their emails and to-do lists in different ways. It all makes perfect sense to me (and I’m assuming most of you). I think about the way our “always on” MD likes to work...

Making Your Data Safe…

We are so used to storing data in the cloud, it is simply how things work these days. Large swathes of your personal life are already cloud-based – all your email addresses, social media profiles, photos etc. are likely to be stored digitally. In your home you may also have connected appliances – also known as the internet of things – such as heating that is controlled via an account synced to an app on your mobile phone. But apart...

Happy Burns' Night

Everyone remembers to wish people a Happy New Year or Merry Christmas when the season approaches, but what about the other, more regional or country specific holidays? Let's say, for example, that I would like to wish a Very Happy Burns Night to all of my Scottish clients….how can I do this in the most efficient way? In the words of Mel Gibson in Braveheart..’ FILTERING !!’ The ability to filter the information or data that you have stored within OpenCRM makes...

From Website Visitor …

Your website is your shop front. You spend time, money, and effort into getting it just right and making sure that people are finding it. Once there, you want to turn as many of these people as you can into actual sales, but first you have to find out a little bit about them. Then you need to nurture that relationship, but I’m getting ahead of myself. Asking people for their contact details via a web form is pretty ubiquitous these days...

Making The Best Use O…

The end of the year tends to be something of an expensive exercise. At home you’ve spent money on food, drinks and presents. At work you have had Christmas parties and a period of closure – all in all it’s not the cheapest time of year. So if now is a time when you are looking to spend a little less, it is the perfect occasion to dig into the existing resources you have to try and make the most out...

Post-Holiday Struggle…

The first week back from the Christmas holidays is almost over and there’s a curious mixture of sadness and gladness at being back at work. There is the tiredness we all feel, the result of a slightly altered sleeping schedule and a week of indulgences and lazy days. Plus you’ve got the slight malaise from bad weather and no bank holidays until April. Finally, there’s the enjoyment that comes from accomplishing something during the day and feeling productive. Some will even look...

Forecasting for 2017

As we approach the end of 2016, it is time to start looking forward to 2017. It’s become a bit of a tradition for me to write a post with a bit of a forecast on what I think the big topics in CRM will be for the New Year. So below are the issues that I think will be the three “big ticket” items in 2017, along with some questions you might want to consider asking your CRM and SaaS...

The Office Christmas …

Last week saw the the usual out of office OpenCRM Christmas Party. Last year we got all dressed to the nines and went Private Dining at Rockliffe Hall so this year we thought how on earth are we going to top that….. PAINTBALL AND PUB!!! We headed off to No Limits Paintball for an afternoon of snipering and target practice for some and lots of ooo’s and ahh’s from others, I was the latter! We had a blast (Pardon the pun)...

Interviewing for a CR…

Whenever I’ve been to an interview, my two favourite questions to ask are: “What is a normal day for someone in this role?” and “What will be your expectations of me after the first three months?” The first question is usually answered with a quick outline of basic jobs and then quickly descends into some of the more quirky, unusual, or random tasks that sometimes crop up. Every time I’ve asked this question, I have walked away with a far better...

Is It Safe To Head Ou…

There are so many ways of receiving the news, and this information becomes so much more powerful when it is designed to answer your questions or make you aware of issues specific to you. One great example of this is Transport Scotland. They have recently worked on developing a website and companion app that lets you know in real-time along which routes their trucks have been gritting the roads. The idea behind the live monitoring is to help give motorists confidence...