Welcome to the OpenCities help centre. Search for what you're after, or browse the categories.
Can't find what you're looking for? Submit a support ticket and we'll be in touch.


Using content labels

avatar of OpenCities Product Team

OpenCities Product Team

Last updated

You can use content labels to organize your content, build content lists, and create maps and calendars targeted towards specific pages. Content labels are for internal use only, so your site visitors will not see them. They are also different from category tags, like those used for events or parks, as they are invisible to your community and cannot be used to search for content. 

Before you start adding content labels to your pages, you should figure out how you want to use them. Ask yourself which feature of OpenCities you wish to use that requires content labels, what labeling convention you will use, and how you will document which labels need to go on which pages. Here are the common use cases:

There are two ways to add content labels – through the site admin or the Supporting information on a page. But firstly, here are a few tips for using and organizing your content labels:

  • Content labels can only be one word, with no spaces. When adding content labels, you should use the same naming convention for all of them. For example, you may want to use title case (ContentLabel) or hyphens to separate words (content-label). How you name your labels is up to you, but using a universal naming convention can help you keep your list of content labels organized and make it easier to add them.
  • Additionally, all your sites will draw from the same list of content labels, so you may also want to specify on your content labels if they're for a specific site. For example, you could use "theatre-festivals" for a theatre subsite. 
  • We recommend documenting your content labels and what they're used for to track which pages need specific labels. For example, if you're setting up a content list of venues for a particular purpose, you should note which label is used on the OC Venue pages, so if you need to add another venue you'll know which label it needs. 

Add content labels to the site admin

This task can be undertaken by users with the following roles: OC System Administrator.

The best way to create your list of content labels is through the site admin. Creating them this way allows you to create a lot of labels simultaneously and make sure you're not doubling up on labels. Here's how to do it:

  1. From the main menu, go to More > Content Labels. You'll see a text field to add labels and a list of any current content labels.
  2. To add content labels, type them into the text field and select Add. You can use the following characters: the letters A-Z, numbers from 0-9, hyphens (-), and underscores (_).
  3. To add several labels at once, separate your labels with a space or a comma.
  4. Once you've added all the labels you need, select Save. Once you've saved the list will organize itself alphabetically.

list of content labels in admin

You'll notice that each label in the list has a number in brackets attached to it. This number refers to how many pages the label is being used on. Selecting this number will show you the list of pages linked to the label and show you its Name, the Site it belongs to, and the page's Status, Owner, and Author. Selecting a page from the list will take you directly to the page's admin.

list of pages attached to a content label

System administrators and Site Managers can also create labels directly on a page:

  1. Open the expandable Supporting information menu in the Overview tab when creating or editing a page.
  2. In the Content labels field, start typing in the label you need. If there is no matching label, finish typing it and hit enter to add it to the page and the content labels list. To add more than one label, separate each one with a space. 
  3. Save or Publish the page.

content labels field with no labels attached

Content authors without the OC Site Manager or OC System Administrator role can add labels to pages, but they cannot create them. To give them this permission, you need to create a new role for them.

Attach content labels to a page or file

Content authors can attach content labels to pages and files as long as it already exists in your content labels list. You can add labels to any page with a Supporting information field.

  1. With the page or file in work-in-progress mode (WIP), open the Supporting information menu in the Overview tab.
  2. Start typing in the label you need in the Content labels field and select it from the list.
  3. If you add a label, you don't need, select the x on the label to remove it.
  4. Save or Publish your page or file.

content labels field with content labels attached

What next?

Was this article helpful?
0 out of 0 found this helpful