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 downloads

Online documentation:

This package is built on the new class labelled introduced by haven package and propose additional functions to manipulate labelled data.

Please note that this package is still under active development.

Missing values are currently not supported anymore by labelled package.


From CRAN:


Latest version from GitHub:


Introduction to labelled


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.


labelled 1.1.0

  • extend dplyr::recode method to be compatible with labelled vectors
  • copy_labels now copy also na_range and na_values attributes
  • new method remove_attributes

labelled 1.0.1

  • bug fix: argument drop_unused_labels could now be used with
  • new labels argument for to_labelled method when applied to a factor
  • bug fix: appropriate column names with data.frame (cf.

labelled 1.0.0

  • now imports haven
  • new function to deal with user defined missing values (SPSS style): na_values(), na_range(), set_na_values(), set_na_values(), remove_user_na(), user_na_to_na().
  • remove_labels() has been updated.

labelled 0.2.3

  • new functions set_variable_labels(), set_value_labels(), add_value_labels() and remove_value_labels() compatible with %>%.
  • new functions remove_val_labels and remove_var_label().
  • bug fix in to_character.labelled() when applied to data frames.

labelled 0.2.2

  • to_factor(), to_character() and to_labelled.factor() now preserves variable label.
  • bug fix in to_factor() when applied to data frames.

labelled 0.2.0

Reference manual

It appears you don't have a PDF plugin for this browser. You can click here to download the reference manual.


2.0.2 by Joseph Larmarange, 4 days ago

Report a bug at

Browse source code at

Authors: Joseph Larmarange [aut, cre] , Daniel Ludecke [ctb] , Hadley Wickham [ctb] , Bojanowski Michal [ctb]

Documentation:   PDF Manual  

GPL-3 license

Imports haven, dplyr, stats

Suggests testthat, knitr, rmarkdown, questionr

Enhances memisc

Imported by SEERaBomb, codebook, crosswalkr, questionr, tableone.

See at CRAN