Learn R Programming

⚠️There's a newer version (1.3.0) of this package.Take me there.

XLConnect: Excel Connector for R

XLConnect is a comprehensive and cross-platform R package for manipulating Microsoft Excel files from within R. XLConnect differs from other related R packages in that it is completely cross-platform and as such runs under Windows, Unix/Linux and Mac (32- and 64-bit). Moreover, it does not require any installation of Microsoft Excel or any other special drivers to be able to read & write Excel files. The only requirement is a recent version of a Java Runtime Environment (JRE).

The package can easily be installed from CRAN via install.packages("XLConnect"). In order to get started have a look at the XLConnect and XLConnect for the Impatient package vignettes, the numerous demos available via demo(package = "XLConnect") or browse through the comprehensive reference manual.

Alternatively, you may install XLConnect directly from our github repository using the excellent devtools package:

require(devtools)

# Installs the master branch of XLConnect (= current development version)
install_github("miraisolutions/xlconnect")

# Installs XLConnect with the given version, e.g. 1.0.2
install_github("miraisolutions/xlconnect", ref = "<version>")

Please log any enhancement requests or bug reports with a simple and self-contained reproducible example as an issue on our github repository. For other questions you may also use Stackoverflow.

Build for release on CRAN

devtools::build(args=c("--compact-vignettes=gs+qpdf"))

Copy Link

Version

Install

install.packages('XLConnect')

Monthly Downloads

4,955

Version

1.2.2

License

GPL-3

Issues

Pull Requests

Stars

Forks

Maintainer

Martin Studer

Last Published

May 26th, 2025

Functions in XLConnect (1.2.2)

clearRangeFromReference-methods

Clearing cell ranges in a workbook
col2idx

Converting Excel column names to indices
createFreezePane-methods

Creating a freeze pane on a worksheet
cloneSheet-methods

Cloning/copying worksheets
createName-methods

Creating names in a workbook
clearSheet-methods

Clearing worksheets in a workbook
configurePOI

Configuring Apache POI
clearNamedRegion-methods

Clearing named regions in a workbook
createCellStyle-methods

Creating custom named and anonymous cell styles
clearRange-methods

Clearing cell ranges in a workbook
cref2idx

Converting Excel cell references to indices
extraction-methods

Workbook data extraction & replacement operators
$-methods

Executing workbook methods in object$method(...) form
getActiveSheetIndex-methods

Querying the active worksheet index
getCellFormula-methods

Retrieving formula definitions from cells
getCellStyle-methods

Retrieving named cell styles
extractSheetName

Extracting the sheet name from a formula
getReferenceCoordinatesForName-methods

Querying the coordinates of the range reference by an Excel name
existsSheet-methods

Checking for existence of worksheets in a workbook
mirai

Mirai Solutions GmbH
createSheet-methods

Creating worksheets in a workbook
createSplitPane-methods

Creating a split pane on a worksheet
getReferenceCoordinates-methods

Querying the coordinates of the range reference by an Excel name
getOrCreateCellStyle-methods

Retrieving or creating named cell styles
getReferenceFormula-methods

Querying reference formulas of Excel names
getTables-methods

Querying available Excel tables in a workbook
getForceFormulaRecalculation-methods

Querying the coordinates of the range reference by an Excel name
getReferenceCoordinatesForTable-methods

Querying the coordinates of the range of an Excel table
getLastRow-methods

Querying the last (non-empty) row on a worksheet
existsCellStyle-methods

Retrieving named cell styles
jTryCatch

Standard Java exception handling for XLConnect
mergeCells-methods

Merging cells
getLastColumn-methods

Querying the last (non-empty) column on a worksheet
getActiveSheetName-methods

Querying the active worksheet name
onErrorCell-methods

Behavior when error cells are detected
hideSheet-methods

Hiding worksheets in a workbook
normalizeDataframe

Data frame Normalization for Unit Tests
existsName-methods

Checking existence of named ranges in a workbook
isSheetVisible-methods

Checking if worksheets are visible in a workbook
isSheetVeryHidden-methods

Checking if worksheets are very hidden in a workbook
getDefinedNames-methods

Retrieving defined names in a workbook
getCellStyleForType-methods

Querying the cell style per data type for the DATATYPE style action
readTable

Reading Excel tables from a workbook
print-methods

Print a workbook's filename
idx2col

Converting column indices to Excel column names
removeSheet-methods

Removing worksheets from workbooks
idx2aref

Converting row and column based area references to Excel area references
readNamedRegionFromFile

Reading named regions from an Excel file (wrapper function)
loadWorkbook

Loading Microsoft Excel workbooks
renameSheet-methods

Renaming worksheets from workbooks
idx2cref

Converting indices to Excel cell references
setDataFormat-methods

Specifying custom data formats for cell styles
readWorksheetFromFile

Reading data from worksheets in an Excel file (wrapper function)
readWorksheet-methods

Reading data from worksheets
setDataFormatForType-methods

Setting the data format for the DATA_FORMAT_ONLY style action
getSheetPos-methods

Querying worksheet position
isSheetHidden-methods

Checking if worksheets are hidden in a workbook
readNamedRegion

Reading named regions from a workbook
getBoundingBox-methods

Querying the coordinates of a worksheet bounding box
getSheets-methods

Querying available worksheets in a workbook
saveWorkbook-methods

Saving Microsoft Excel workbooks
setActiveSheet-methods

Setting the active worksheet in a workbook
setCellStyleForType-methods

Setting the cell style per data type for the DATATYPE style action
setCellStyle-methods

Setting cell styles
setAutoFilter-methods

Setting auto-filters on worksheets
removeName-methods

Removing names from workbooks
setHyperlink-methods

Setting hyperlinks
setMissingValue-methods

Setting missing value identifiers
setCellFormula-methods

Setting cell formulas
removePane-methods

Removing panes from worksheet
setSheetColor-methods

Setting colors on worksheet tabs
setBorder-methods

Specifying borders for cell styles
setForceFormulaRecalculation-methods

Forcing Excel to recalculate formula values when opening a workbook
setColumnWidth-methods

Setting the width of a column in a worksheet
setFillPattern-methods

Specifying the fill pattern for cell styles
setRowHeight-methods

Setting the height of a row in a worksheet
setWrapText-methods

Specifying text wrapping behaviour
with.workbook

Evaluate an R expression in a workbook environment
swissfranc

Historical Exchange Rates: CHF vs EUR, USD and GBP
setSheetPos-methods

Setting worksheet position
xlcCall

Automatic argument vectorization, default Java exception and warnings handling for XLConnect
setStyleNamePrefix-methods

Setting the style name prefix for the "name prefix" style action
xlcMemoryReport

Reporting free Java Virtual Machine memory
unhideSheet-methods

Unhiding worksheets in a workbook
show-methods

Display a workbook object
setStyleAction-methods

Controlling application of cell styles when writing data to Excel
unmergeCells-methods

Unmerging cells
setFillBackgroundColor-methods

Specifying the fill background color for cell styles
xlcDump

Dumping data sets to Excel files
setFillForegroundColor-methods

Specifying the fill foreground color for cell styles
summary-methods

Summarizing workbook objects
xlcRestore

Restoring objects from Excel files
writeWorksheetToFile

Writing data to worksheets in an Excel file (wrapper function)
writeWorksheet-methods

Writing data to worksheets
xlcEdit

Editing data sets in an Excel file editor
workbook-class

Class "workbook"
xlcFreeMemory

Freeing Java Virtual Machine memory
writeNamedRegionToFile

Writing named regions to an Excel file (wrapper function)
wrapList

Wrapping of arguments in a list
writeNamedRegion-methods

Writing named regions to a workbook
XLC

XLConnect Constants
XLConnect-deprecated

Deprecated functions in package XLConnect
aref2idx

Converting Excel cell references to row and column based cell references
aref

Constructing Excel area references
appendWorksheet-methods

Appending data to worksheets
appendNamedRegion-methods

Appending data to a named region
XLConnect-package

Excel Connector for R
XLConnectSettings

Performing general settings for XLConnect
cellstyle-class

Class "cellstyle"
addImage-methods

Adding images to a worksheet