File Exchange

image thumbnail


version (6.36 KB) by Brett Shoelson
Append data to the next-available row of an existing Excel file with a single call to ActiveX.


Updated 01 Sep 2016

View License

SYNTAX: [success,message] = xlsappend(file,data,sheet)
XLSAPPEND Stores numeric array or cell array to the end of specified Excel sheet.

REQUIRES ONLY ONE CALL TO THE EXCEL ACTXSERVER, so the overhead is less than for successive xlsread/xlswrite calls.

[SUCCESS,MESSAGE]=XLSAPPEND(FILE,ARRAY,SHEET) writes ARRAY to the Excel workbook, FILE, into the area beginning at COLUMN A and FIRST UNUSED ROW, in the worksheet specified in SHEET. FILE and ARRAY must be specified. If either FILE or ARRAY is empty, an error is thrown and XLSAPPEND terminates. The first worksheet of the workbook is the default. If SHEET does not exist, a new sheet is added at the end of the worksheet collection. If SHEET is an index larger than the number of worksheets, new sheets are appended until the number of worksheets in the workbook equals SHEET. The success of the operation is returned in SUCCESS and any accompanying message, in MESSAGE. On error, MESSAGE shall be a struct, containing the error message and message ID.

Cite As

Brett Shoelson (2020). XLSAPPEND (, MATLAB Central File Exchange. Retrieved .

Comments and Ratings (44)

An Ke

Arunachalam Sundaram

it works perfectly. Thank you


Thanks Brett. I used the download button and it gave me a zip file but the content was only the license. I will contact tech support as you suggest. Very odd.

Brett Shoelson

...just downloaded the file and I got a zip file with the license agreement and the xlsappend function. If the Download button isn't working for you, I would suggest that you call tech support.


okay. So what's the purpose of the big download button to the upper right? Seems odd that the big button is for the license and you have to go to another tab for the download especially since the "View License" is a link to the license. JS

Brett Shoelson

@Patricia: I assure you the file is there; you appear to have made a mistake in your downloading. Click on the "Functions" tab above--you can see the file.


nothing in the file except a licence.

Brett Shoelson

@Jalil, Hazoor, Olivier: Thanks for the comments and ratings!
@Olivier: 2009a???? Time to update--we've come a long way since then!

Olivier Doyle

Used on 2009a with minimal adaptation (removed ~ assigned to output on line 282). Works fast and outputs appropriate errors when needed. Thank you!

Hazoor Ahmad

It is really an amazing function helped a lot for me

Jalil Sharafi

Excellent work. Thanks.

Brett Shoelson

@Amine: Thanks for the note and the rating! Glad it was helpful. Brett


this is really helpfull I spent too much time looking for a function to append new rows on excel file , thank you

Brett Shoelson

@H.K. Please try to convert to char before appending. (char(x)). Let me know if that works for you!

H.K. Sardana

I have a huge two column array consist of string(col 1) and numeric data(col2).... how do I append the entire array... as string is not a valid input for the function... help help!

Brett Shoelson

First, that is a warning, not an error. You can suppress it (docsearch "suppress warnings") or ignore it until nargchk is truly deprecated, at which time you can replace the nargchk call with narginchk instead. XLSAPPEND will continue to work (and throw the warning) until that happens. Or you can go ahead and make that substitution now.
The problem with repeated calls failing has nothing to do with the warning. I think you need to ensure that XLSAPPEND is on your MATLAB path (docsearch "MATLAB Path"). I think you are changing directories somewhere, and MATLAB is losing the link to that file.

Kristen Farrell

I am new to matlab and I can't get this function to work.
When I run this code, I get the following error:

Warning: NARGCHK will be removed in a future release. Use NARGINCHK or NARGOUTCHK instead.
> In xlsappend (line 138)
Warning: NARGCHK will be removed in a future release. Use NARGINCHK or NARGOUTCHK instead.
> In xlsappend (line 139)
Error using xlsappend (line 139)
Not enough input arguments.

Despite this error, when I go back to the script I have written, "xlsappend" works great and saves my variables to excel.
This is how I'm using xlsappend in my code:

[success, message] = xlsappend('fileName',excelVariables,2);

But as soon as my variables are cleared for the next piece of analysis, xlsappend is no longer recognised unless I repeat the entire process. The error reads:

Undefined function or variable 'xlsappend'.

I want to call on this function in my own code so that this can be automated, but since this function keeps throwing that same error, this stops my script from finishing.

Please help!
I'm using matlab version 2016b.

Brett Shoelson

To write strings to single cells, submit them in a cell array. For example:

xlsappend( 'myExcelDoc.xlsx', { 'test1' , 'test two' } )


Maria Jaramillo

Hi Brett! Question how can I get it to group string like data into each cell? I was able to make it work except that for a value of 0.00 it take a cell for each digit.

Brett Shoelson

Yes, this is an ActiveX-based solution, and runs on a PC. Sorry--I don't have a version that will work on a Mac. (Not sure about Linux.)

Madina Makhmutova

Does this run on Mac?
I have 2011 and 2017 versions of Excel for Mac on my computer.
I keep getting an error:
"Warning: Could not start Excel server for export.
XLSWRITE will attempt to write file in CSV format."
I get the same error if I use xlswrite. Is it just because those functions are not formatted for Mac?

Michal Dobai

Brett Shoelson

Yes, 2009a was a long time ago. You might be able to change some things to get it to work in that version, but I wrote it for a "modern" session of MATLAB. ;)
For one thing, line 282 uses the tilde for unwanted outputs:
[~, n, e] = fileparts(filePath);
That was introduced later. Try replacing the line with:
[junk, n, e] = fileparts(filePath);

Vikram Baliga

getting this error: Error: File: xlsappend.m Line: 282 Column: 11
Expression or statement is incorrect--possibly unbalanced (, {, or [.

Using MATLAB R2009a. Is it the version incompatibility?

Dulara De Zoysa

Lukas Tietz

Chetankumar Vegad


Kyle Reagan

Jibran Shahid

great work ...



Working great, thank you

Abdulaziz Abutunis

TOO much time was saved. Thank you.




Andy S

The property usedrange is the problem. I suppose you would have to use the method of selecting the bottom cell (eg. A64000) and do xlup to find the next row that doesn't contain data.

If you format the entire column by selecting the header, then there is no problem since usedrange doesn't count that as being using since the entire worksheet has formatting.

Andy S

Hey man, I'm trying to figure out how to get it to ignore formatting to determine the next row to append data to. I've pre-formatted a spreadsheet and it adds it to the next row below all of that. I could reformatt the sheet by copy/paste format everytime I import data but that's kind of a pain. Any help?

Brett Shoelson

Thanks for sharing the rating, and for your modification suggestion, Ralph. Much appreciated!


Very useful function. Thank you.

I added the following prior to line 160 to create file if it does not already exist (motivated by xlswrite1):

if ~exist(file,'file')
ExcelWorkbook = Excel.workbooks.Add;
switch ext
case '.xls' %xlExcel8 or xlWorkbookNormal
xlFormat = -4143;
case '.xlsb' %xlExcel12
xlFormat = 50;
case '.xlsx' %xlOpenXMLWorkbook
xlFormat = 51;
case '.xlsm' %xlOpenXMLWorkbookMacroEnabled
xlFormat = 52;
xlFormat = -4143;


Very useful submission. Just make sure the file already exists.

Akansha Saxena

Brett Shoelson

The first time you call the function, make sure that you have specified the filename properly, including the exact extension. ("XLS," "XLSX," ...). If appendToXLS doesn't find the Excel file, it will create a CSV-formatted one and operate on it. If that doesn't address your question, please feel free to contact me directly. Perhaps I could figure out specifics if I had your file to work with.


thanks for sharing! I have a warning the second time I call the function:
Warning: Could not start Excel server for export.
XLSWRITE will attempt to write file in CSV format.
Do I have a problem with ActiveX. How could I solve it? Thanks a lot



Rossella Blatt Vital

Very nice! Thanks!


Updated license

9/7/2010 Update to fix some intro verbiage.

MATLAB Release Compatibility
Created with R2010a
Compatible with any release
Platform Compatibility
Windows macOS Linux