Skip to content

Blacktagging vs Whitetagging

terrelsa13 edited this page Jul 4, 2025 · 7 revisions

Tagging Options During Setup

  • During creation of the mumc_config.yaml, MUMC will give the option to enter a comma separated list of blacktags and/or whitetags.
    • blacktags entered during setup are global and apply to all media_types
    • whitetags entered during setup are global and apply to all media_types
    • The same tag cannot be used for both a blacktag and a whitetag
    • Backslash \ is not an allowed character
  • media_type specific tags can be used by adding the media_type and then adding a list of tags for the specified media_type
advanced_settings:
  whitetags:
    global: [list,of,strings] #yaml lists can be on one line like this
    media_type: #yaml lists can also be over multiple lines like this
    - list
    - of
    - strings
  blacktags:
    global: #yaml lists can also be over multiple lines like this
    - list
    - of
    - strings
    media_type: [list,of,strings] #yaml lists can be on one line like this

Use Blacktagging When

Use Whitetagging When

Tagging

  • Is optional
  • Multiple tags can be used
  • Tags must be in yaml list format
  • Global tags apply to all media_types
  • Media specific tags apply only to the media_types they are specified under
  • Tags apply to all monitored_users
  • Whitetags have a higher priorty than Blacktags

Blacktag Examples

  • Examples of how Blacktagging usually works:
advanced_settings:
  blacktags:
    global:
    - deletetag
    - delete tag
    - delete-tag
.
.
.
admin_settings:
  users:
  - user_id: ...
    user_name: user0
    whitelist:
    - lib_id: ...
      collection_type: library0
      path: ...
      network_path: ...
      lib_enabled: true
    blacklist:
    - lib_id: ...
      collection_type: library1
      path: ...
      network_path: ...
      lib_enabled: ...
  • Blacktagged media_items from library0 could be deleted

  • Blacktagged media_items from library1 could be deleted

Whitetag Example

  • Examples of how Whitetagging usually works:
advanced_settings:
  whitetags:
    global:
    - keeptag
    - keep tag
    - keep-tag
.
.
.
admin_settings:
  users:
  - user_id: ...
    user_name: user0
    whitelist:
    - lib_id: ...
      collection_type: library0
      path: ...
      network_path: ...
      lib_enabled: true
    blacklist:
    - lib_id: ...
      collection_type: library1
      path: ...
      network_path: ...
      lib_enabled: ...
  • Whitetagged media_items from library0 could be kept

  • Whitetagged media_items from library1 could be kept

Additional Information - MUMC extras.

Clone this wiki locally