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: 10 November 2016 09:06:10 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


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...

Festive Decorations: …

It’s easy for people to get caught up in the festive spirit at a time like this. Some people will want to decorate their desk or the whole office. Others will bring in mince pies and sing carols, nonstop, from 9am on the 1st of December. It can make this cold and dark month feel immediately cheery. But what about people who don’t enjoy Christmas? Or don’t celebrate it? How do you make sure that no one feels left out in the...

Keep those Leads Nice…

Just in case you hadn’t noticed it is now quite cold, I know this first hand as my heating went pop last week (cue the violins). However just because it is cold outside you should still make sure you keep all those valuable Leads nice and warm. By managing your Leads correctly you make sure you get the most out of every Opportunity, whether you are entering your Leads manually into OpenCRM or automatically via your website for instance. Action Plans are...

The Customer Portal: …

Every system we create has a little window built into the side of it. We call it the Customer Portal and it gives you the ability to forge an even closer connection with your customers. And the best part? It’s completely free to use, just ask our support team to switch it on for you. You’ll be live within a matter of minutes. So what can you do with the Customer Portal? How does it bring you closer to your customers? Well, there...

Acknowledge Your Know…

Within many businesses, the information that you possess is as valuable as the physical assets you hold. Firstly you need to keep your all-important records of your day-to-day trading. Invoices, purchase orders, personnel costs – everything that makes you accountable to the taxman. Secondly your customer database is your real intellectual money in the bank. It is data like this that have helped make the likes of Facebook, Amazon or Google the businesses they are today, as they are able...

I’m Thankful For…

Just by a strange happenstance, I am posting a blog on the American Thanksgiving, so it feels rude not to at least mention the holiday. I’ve been told, by one of our resident Americans here at OpenCRM, that a Thanksgiving tradition is to say what you are thankful for during the meal. Now, I’m going to wait until Christmas to sit down to a big turkey dinner, but I can certainly say what I’ve been thankful for this year: UK Cloud Awards This...

After the Lord Mayors…

As you may have seen on Twitter, I was delighted to attend the North East Expo last week, as described in my recent blog post. But what now? When you get back from a conference, expo, or other big event, there’s still some work to be done. You have all of the information that you collected on the day, don’t let it all go to waste. Enter that data! By entering all of the names and information you collected into OpenCRM, you can...

Keeping Track of Empl…

With the Christmas break looming on the not-so-distant horizon, the subjects of holiday time and opening hours are being discussed up and down the country. A lot of offices close over the holiday period, there are a number of bank holidays, and people need to take extra time off to look after kids who are out of school or just to recover from the inevitable parties. Juggling all of these requests can be tricky for an HR department (or individual). So what...

How To Guarantee Quan…

I'm not sure if you're familiar with the concept of six degrees of separation? The ideas is that all living people are six steps or less from one another, making the entire world population reasonably close. Bearing this in mind, you may well have hundreds of friends, families, business or other associates floating around your network. LinkedIn has even turned this into a feature, showing you people within your environment as being 1st degree, 2nd degree and 3rd degree of...