Install specified version or relative version of a CRAN package.



If you are installing an package that contains compiled code, you will need to have an R development environment installed. You can check if you do by running has_devel.


install_version(package, version = NA, compare = NA,
  repos = getOption("repos"), type = getOption("pkgType"), ...)



package name


If the specified version is NA or the same as the most recent version of the package, this function simply calls install. Otherwise, it looks at the list of archived source tarballs and tries to install an older version instead.


If specified, and if the version is specified, enforces comparison of the package version. Valid values: ==, <, >, >=, or <=


Other arguments passed on to install.


character vector, the base URL(s) of the repositories to use, e.g., the URL of a CRAN mirror such as "".

Can be NULL to install from local files (with extension ‘.tar.gz’ for source packages).


character, indicating the type of package to download and install.

Possible values are "source", "mac.binary.leopard" and "win.binary": the binary types can be listed and downloaded but not installed on other platforms.

The default is the appropriate binary type on Windows and on the CRAN binary OS X distribution, otherwise "source". For the platforms where binary packages are the default, an alternative is "both" which means ‘try binary if available, otherwise try source’. (This will only choose the binary package if its version number is no older than the source version. In interactive use it will ask before attempting to install source packages.)


Note: This is an updated version of devtools 'install_version' It has been fixed to work with the latest CRAN repository and updated to support version comparisons (i.e. >, ==, <, etc.)


whether the version was installed


Jeremy Stephens

Yoni Ben-Meshulam