Release package to CRAN.

Run automated and manual tests, then ftp to CRAN.

release(pkg = ".", check = TRUE, args = NULL, spelling = "en_US")

package description, can be path or package name. See as.package for more information


if TRUE, run checking, otherwise omit it. This is useful if you've just checked your package and you're ready to release it.


An optional character vector of additional command line arguments to be passed to R CMD build.


language or dictionary file to spell check documentation. See spell_check. Set to NULL to skip spell checking.


The package release process will:

  • Confirm that the package passes R CMD check

  • Ask if you've checked your code on win-builder

  • Confirm that news is up-to-date

  • Confirm that DESCRIPTION is ok

  • Ask if you've checked packages that depend on your package

  • Build the package

  • Submit the package to CRAN, using comments in ""

You can also add arbitrary extra questions by defining an (un-exported) function called release_questions() that returns a character vector of additional questions to ask.

You also need to read the CRAN repository policy at and make sure you're in line with the policies. release tries to automate as many of polices as possible, but it's impossible to be completely comprehensive, and they do change in between releases of devtools.


If a devtools bug causes one of the CRAN maintainers to treat you impolitely, I will personally send you a handwritten apology note. Please forward me the email and your address, and I'll get a card in the mail.

  • release
Documentation reproduced from package devtools, version 1.13.5, License: GPL (>= 2)

Community examples

Looks like there are no examples yet.