Skip to content

Customizing Profiles

To customize a BagIt profile, click the name of the profile in the profiles list, or click new and follow the steps to create a BagIt profile.

BagIt Profile List


The About tab of the BagIt profile editor enables you to set a name and description for your profile.

BagIt Profile About tab


The Info tab includes fields to edit the BagIt-Profile-Info section of the profile. This includes the profile's URL identifier.

BagIt Profile Info tab


The General tab includes information about which BagIt versions your profile accepts, whether to allow fetch.txt files, and whether to allow miscellaneous top level files (arbitrary tag files directly under the root directory) and miscellaneous directories outside the payload (/data) directory.

BagIt Profile General tab


The Manifests tab specifies which manifests and tag manifests your profile requires. You can select multiple options from each list by holding down the Control key on Windows or the Command key on Mac while you click.

BagIt Profile Manifests tab


The Serialization tab allows you to specify whether serialization is required, optional, or forbidden, as well as which serialization formats are supported. You can also specify here whether serialized bags must deserialize to a directory whose name matches the serialized file name. (For example, my_bag.tar must untar to my_bag and must unzip to my_bag.)

BagIt Profile Serialization tab

Tag Files

The Tag Files tab includes a drop-down list for editing the profile's tag files, and for adding new tag files.

BagIt Profile Tag Files tab

Adding a New Tag File

To add a new tag file:

  1. Click Add New Tag File on the drop-down list.

  2. Enter a name for the tag file. If the name includes slashes, the tag file will be created in a subdirectory beneath the bag's root directory. For example, custom-tags/photo-credits.txt would be placed in the bag's custom-tags directory.

  3. Click the Save button.

BagIt Profile New Tag File dialog

Editing a Tag File

To edit a tag file:

  1. Click the Tag Files tab.

  2. Select the name of the file you want to edit.

BagIt Profile Tag Files tab

Adding a Tag

To add a tag to a tag file, click the New Tag button (visible in the screenshot above), then follow the steps in Editing a Tag below.

Editing a Tag

To edit a tag:

  1. Click the name of the tag you want to edit.

  2. Set the appropriate values in the dialog.

    1. Tag Name - The name of the tag. This is required.

    2. Required - A Yes/No value indicating whether the tag must have a value for the bag to be considered valid.

    3. Values - An optional list of allowed values for this tag.

    4. Default Value - An optional default value for this tag.

    5. Help - An optional help message. This message will be displayed to users who are filling out a bag's tag values in DART.

  3. Click the Save button.

BagIt Profile tag definition

Deleting a Tag

To delete a tag, click the red X to the right of the tag name in the tag list view. If the tag does not have a red X, it is a required tag from a published profile and cannot be deleted. When you delete the last tag of a tag file, DART deletes the tag file as well.

BagIt Profile Tag Files tab

Deleting a Tag File

To delete a tag file, delete all of the tags in the file. See Deleting a Tag above.