Migrate to v0.11 (Add-in)¶
This migration guide shows you how you can start using the new xlwings add-in as opposed to the old xlwings VBA module (and the old add-in that consisted of just a single import button).
Upgrade the xlwings Python package¶
Check where xlwings is currently installed
>>> import xlwings >>> xlwings.__path__
If you installed xlwings with pip, for once, you should first uninstall xlwings:
pip uninstall xlwings
Check the directory that you got under 1): if there are any files left over, delete the
xlwingsfolder and the remaining files manually
Install the latest xlwings version:
pip install xlwings
Verify that you have >= 0.11 by doing
>>> import xlwings >>> xlwings.__version__
Install the add-in¶
- If you have the old xlwings addin installed, find the location and remove it or overwrite it with the new version (see next step).
If you installed it via the xlwings command line client, you should be able to do:
xlwings addin remove.
- Close Excel. Run
xlwings addin installfrom a command prompt. Reopen Excel and check if the xlwings Ribbon appears. If not, copy
xlwings.xlam(from your xlwings installation folder under
addin\xlwings.xlammanually into the
XLSTARTfolder. You can find the location of this folder under Options > Trust Center > Trust Center Settings... > Trusted Locations, under the description
Excel default location: User StartUp. Restart Excel and you should see the add-in.
Upgrade existing workbooks¶
- Make a backup of your Excel file
- Open the file and go to the VBA Editor (
- Remove the xlwings VBA module
- Add a reference to the xlwings addin, see Installation
- If you want to use workbook specific settings, add a sheet
xlwings.conf, see Workbook Settings
Note: To import UDFs, you need to have the reference to the xlwings add-in set!