labelled v2.2.1


Monthly downloads



Manipulating Labelled Data

Work with labelled data imported from 'SPSS' or 'Stata' with 'haven' or 'foreign'. This package provides useful functions to deal with "haven_labelled" and "haven_labelled_spss" classes introduced by 'haven' package.



Project Status: Active - The project has reached a stable, usable
state and is being actively
developed. Travis-CI Build
Status CRAN\_Status\_Badge Rdoc Downloads DOI

This package is built on the new classes haven_labelled and haven_labelled_spss introduced by haven package to handle labelled variables imported from SPSS, Stata and SAS. The labelled package propose several functions to manipulate such vectors and their metadata: variable labels, value labels and user-defined missing values.


From CRAN:


Latest version from GitHub:


Introduction to labelled

Read the vignette at

Breaking changes introduced in version 2.0.0

Following version 2.0.0 of haven, labelled() and labelled_spss() now produce objects with class “haven_labelled” and “haven_labelled_spss”, due to conflict between the previous “labelled” class and the “labelled” class used by Hmisc.

A new function update_labelled() could be used to convert data imported with an older version of haven to the new classes.

Some general principles

  1. Functions are intented to support labelled metadata structures only. However, to_labelled method allows to convert metadata from foreign and memisc packages.
  2. Functions should, by default, modify metadata only (i.e. classes and attributes), except if explicitly expressed by the user.

Functions in labelled

Name Description
remove_attributes Remove attributes
nolabel_to_na Recode values with no label to NA
remove_labels Remove variable label, value labels and user defined missing values
to_character Convert input to a character vector
to_factor Convert input to a factor.
val_labels Get / Set value labels
recode.haven_labelled Recode values
val_labels_to_na Recode value labels to NA
mean.haven_labelled Arithmetic mean for numeric labelled vectors
na_values Get / Set SPSS missing values
var_label Get / Set a variable label
copy_labels Copy variable and value labels and SPSS style missing value
to_labelled Convert to labelled data
update_labelled Update labelled data to version 2.0.0
labelled Create a labelled vector.
labelled_spss Create a labelled vector with SPSS style of missing values.
look_for Look for keywords variable names and descriptions
sort_val_labels Sort value labels
tagged_na "Tagged" missing values
No Results!

Vignettes of labelled

No Results!

Last month downloads


Type Package
License GPL-3
Encoding UTF-8
LazyData true
VignetteBuilder knitr
RoxygenNote 6.1.1
NeedsCompilation no
Packaged 2019-05-26 15:28:13 UTC; jlarmarange
Repository CRAN
Date/Publication 2019-05-26 15:50:34 UTC

Include our badge in your README