Manage Labels

You can only change labels within spaces that you have space administrator permissions for.

Use this script to rename, add, and remove page labels in bulk. 

Labels can't contain spaces or uppercase letters. If you want a label to contain more than one word, use an underscore or a hyphen, which are the only two special characters allowed. They can contain a maximum of 255 characters.

Run the script

There are three ways to run this script, outlined in the following tasks: 

Adding Labels

  1. Select Space Tools from the bottom left-hand corner of the screen.
  2. Select Advanced Space Functionality.
  3. Select Manage Labels.
  4. Choose the Content Type from: 
    • All Content Types
    • Page
    • Blog
    • Attachment

  5. Choose the Location.

    • To work with an entire space, choose Select Space(s), and then choose the Target Space(s).

    • To work with certain pages in a space, choose Select page(s) within a specific space, and then choose the Space and Page(s). 

      This is unavailable if you're working with All Content Types in Content Type.

  6. For Label Action, choose Add Label(s). 

  7. Enter the Label Name(s) you would like to add to the selected space and pages.

    If All Content Types is selected for Content Type, the action also applies to attachments on the page.

  8. Select Run.
    You can select Preview instead of Run to view changes before implementing them. 
    Once you select Run, the Results of the script appear.
    The script form filled out with content to add a label

Results

The labels that were added appear on the Results list: 

Example results for the Adding a Label example

Removing Labels

  1. Select Space Tools from the bottom left-hand corner of the screen.
  2. Select Advanced Space Functionality.
  3. Select Manage Labels.
  4. Choose the Content Type from: 
    • All Content Types
    • Page
    • Blog
    • Attachment

  5. Select the Location where you want to run the script:

    • To work with all spaces, choose All Spaces.

    • To work with certain spaces, choose Select Space(s), and then select the Target Space(s).

    • To work with certain spaces and pages, choose Select page(s) within a specific space, and then choose the Space and Page(s). 

      This is unavailable if you're working with All Content Types in Content Type.

  6. Select Remove Label(s). 

  7. Enter the Label Name(s) you would like to be removed from selected or all spaces.

  8. Select Run.
    You can select Preview instead of Run to view changes before implementing them. 
    Once you select Run, the Results of the script appear.
    Script form with example content to remove a label

Results

The removed labels appear in the Results list: 

Example results for removing a label

Renaming Labels

  1. Select Space Tools from the bottom left-hand corner of the screen.
  2. Select Advanced Space Functionality.
  3. Select Manage Labels.
  4. Choose the Content Type from: 
    • All Content Types
    • Page
    • Blog
    • Attachment

  5. Select the Location where you want to run the script:

    • To work with all spaces, choose All Spaces.

    • To work with certain spaces, choose Select Space(s), and then select the Target Space(s).

    • To work with certain spaces and pages, choose Select page(s) within a specific space, and then choose the Space and Page(s). 

      This is unavailable if you're working with All Content Types in Content Type.

  6. Select Rename Label(s). 

  7. Enter the Original Label Name(s) of the new label and the New Label Name you want the label to be called.

  8. Select Run.
    You can select Preview instead of Run to view changes before implementing them. 
    Once you select Run, the Results of the script appear.
    Script form with example content to rename a label

Results

The renamed labels appear in the Results list: 

Example results for renaming a label

On this page