g.mapset - GRASS manual
Author: GRASS Development Team
Description: g.mapset: Optionally, creates new mapset or lists available mapsets in given project (location).
Keywords: general, settings, project

## NAME

g.mapset - Changes or reports current mapset.
Optionally, creates new mapset or lists available mapsets in given project (location).

## KEYWORDS

general, settings, project

## SYNOPSIS

g.mapset
g.mapset --help
g.mapset [-clp] mapset=name [project=name] [dbase=path] format=name [--overwrite] [--help] [--verbose] [--quiet] [--ui]

### Flags:

-c
  Create mapset if it doesn't exist
-l
  List available mapsets and exit
-p
  Print current mapset and exit
--overwrite
  Allow output files to overwrite existing files
--help
  Print usage summary
--verbose
  Verbose module output
--quiet
  Quiet module output
--ui
  Force launching GUI dialog

### Parameters:

mapset=name [required]
  Name of mapset (default: current search path)
  Name of mapset where to switch
project=name
  Project (location) name
  Project name (not path to project)
dbase=path
  GRASS database directory
  Default: path to the current GRASS database
format=name [required]
  Output format
  Options: plain, json
  Default: plain
  plain: Plain text output
  json: JSON (JavaScript Object Notation)

## DESCRIPTION

g.mapset changes the current working mapset, project (formerly known as location), or GISDBASE (directory with one or more projects).

With g.mapset, the shell history (i.e. `.bash_history` file of the initial project will be used to record the command history.

## NOTES

By default, the shell continues to use the history for the old mapset. To change this behaviour the history can be switched to record in the new mapset's history file as follows:

    # bash example
    history -w
    history -r /"$GISDBASE/$LOCATION/$MAPSET"/.bash_history
    HISTFILE=/"$GISDBASE/$LOCATION/$MAPSET"/.bash_history

## EXAMPLES

### Print the name of the current mapset

To print the name of the current mapset, use the -p command as shown below:

    g.mapset -p

### List available mapsets

To list available mapsets, use the -l command as shown below:

    g.mapset -l

This should list all the mapsets, such as: "landsat new PERMANENT user1."

### Change the current mapset

To change the current mapset to "user1" use the following command:

    g.mapset mapset=user1 project=nc_spm_08_grass7

You should receive the following message: "Mapset switched. Your shell continues to use the history for the old mapset."

### Create a new mapset

To create a new mapset, use the -c tag as shown below:

    g.mapset -c mapset=new project=nc_spm_08_grass7

## SEE ALSO

g.gisenv, g.mapsets

## AUTHOR

Radim Blazek

## SOURCE CODE

Available at: g.mapset source code (history)

Latest change: Wednesday Mar 25 06:38:01 2026 in commit: 8a26c8890a5b4cf503a4ec5522d81a72866f642e

Main index | General index | Topics index | Keywords index | Graphical index | Full index

© 2003-2026 GRASS Development Team, GRASS 8.6.0dev Reference Manual