help for missingplot 

A plot to show patterns of missing values in a dataset

missingplot [varlist] [if exp] [in range] [, all labels variablenames scatter_options]


missingplot gives a plot showing the incidence of missing values in one or more variables in the current dataset. The horizontal axis shows observation numbers; the vertical axis shows one or more lines, one for each variable shown. Marker symbols show which values are missing.

missingplot treats numeric and string variables alike: what is common to both is whether the missing() function returns true. In the case of numeric variables no distinction is made between system missing (.) and any extended missing value .a ... .z. See missing for a tutorial if desired. Users wishing to select classes of variables, for example all numeric or all string variables, may wish to use first either ds or findname (if installed).

missingplot may be useful for seeing broad patterns in the incidence of missing values, for example blocks of observations with many or all missing values or variables with many or all missing values. It may also be useful for quickly identifying fine structure or notable detail in some instances. See also misstable (Stata 11 up) and nmissing (if installed).


For a loosely similar plot, see Wilkinson (2005, p.487). Users of this program knowing of references to interesting earlier or similar work are encouraged to send references to the program author.

The mechanics of the plot are that each variable in the plot is represented by a single variable inside the program. There is currently a limit of 20 variables being shown in any one graph.


all specifies that all variables implied by varlist should be plotted, regardless of whether they contain missing values. The default of missingplot is to omit variables from the plot if they have no missing values (in the observations selected, if either if or in has been specified). Specifying all is more likely to trigger the limit of 20 variables shown.

labels specifies that marker labels be shown identifying the observation number of each missing value. In practice this will work best with a small number of missing values or a small dataset or both. Note that as above marker labels are generated by repeated calls to marker label options for each variable; thus if you wish to change away from the default you would need to specify (e.g.) mlabcolor(blue ..).

variablenames specifies that variable names only be shown to identify variables. The default is to show variable labels if they exist, and variable names otherwise. The value of this option is usually to increase the space devoted to the graph itself.

scatter_options are options of scatter.


. webuse nlsw88, clear . missingplot . missingplot, var labels . missingplot, var labels mlabcolor(blue ..)


Nicholas J. Cox, Durham University, U.K. n.j.cox@durham.ac.uk


Cox, N.J. 1999. Numbers of missing and present values. Stata Technical Bulletin 49: 7-8. (Software updates Stata Technical Bulletin 60: 2-3; Stata Journal 3:449 and 5:607)

Cox, N.J. 2010. Finding variables. Stata Journal 10: 281-296. (Software updates Stata Journal 10:691 and 12:167)

Wilkinson, L. 2005. The Language of Graphics. New York: Springer.

Also see