How can I create an article in the Content Management system? How can I place a link? How can I format text? How can I tag content? How can I add a photo to an article? Read this How-To!

Cat on laptop

8 Steps to create an article
  1. Creating the article
  2. Uploading the article lead photo
  3. Entering text
  4. Formatting text
  5. Setting links
  6. Assets and media
  7. Categorizing and tagging
  8. Publishing

Step 1: Creating the article

In the Content menu you will find the option Add content - Article. This will open the article dialog. Provide a title as heading. A good heading is supposed to be short, offers an insight into the content and awakes interest. Read more about headings in What makes a good article? Guidelines for

Step 2: Uploading the article lead photo

Under the title line, you will be able to upload the article lead photo. It will be shown as a thumb on the homepage (if set viewmode: teaser in the grid). Pay attention to the format of the photo: All photos have to be landscape with an aspect ratio of 3:2 (width:height). Choose the photo with the highest resolution. The program will automatically downscale the resolution. The minimum size is 630x420 pixels.  See our tips about photo licenses and how to find suitable photos. Finally, add some information about the photo.

  • License: This is a mandatory field. Provide the license of the image here. If you don't know what a license is, read this article.
  • Creator: Enter the photographer's name. It is also a mandatory field.
  • Caption: This text will be shown below the image. It provides information about the place where the photo was taken and the people in the photo. At best, the capture can be an additional motivation to read the article. That means: Don't just describe what can be seen (for instance: dollar bills) but maybe: Transparency, where does the money for fossile fuel come from and where does it go to The system will automatically add a full stop.
  • Alternate text/title: These two fields will not straight away be visible. The title is the information which appears when the image cannot be displayed. It appears as a tooltip when you hover over the image. The alternate text will be used by screen readers (for people with disabilities) and by search engines. It is sufficient to provide a short description of the image.
Step 3: Entering text

Text is to be entered into the Body editor window. Don't just copy the text from a Word document because this will copy the formatting as well and may end up in an incorrect rendering of the text.

Copy the text into an editor first. The editor is a simple text processor which removes all formatting from texts. You will find the editor (in Windows usually called Notepad) in the Accessories of your computer.  Copy the text into the editor and paste it into the Body afterwards. As an alternative, you can write the text directly into the Body field.

Step 4: Formatting text

Now you can format the text. Copy the teaser text from the teaser field and make it bold. That will make the teaser appear above the article full text.

Extremely important: Subheadings. They make it easier for readers to scan and read the text. Add a subheading after every two to three paragraphs and make it Überschrift 2 (Heading 2).

Step 5: Setting links

Don't forget the links! The great thing about online texts is, that you can easily link to other (internal or external) pages.  Mark the text which is to be linked and click on the button with the chain symbol. Here you can enter the URL (link address).

For external links it looks like this:

Please note: In order to link to internal pages, the text format of the Body editor (which is under Body) has to be Filtered HTML while by default it is Comment HTML.

When you have

  • chosen the option Filtered HTML
  • marked the text to be linked
  • clicked on the link (chain) symbol

the link dialog will provide the option to link to internal pages. In the link line you can search for existing pages by their title:

You can also place anchor links within one page. This may be useful when you want to link from a table of contents at the beginning of the text to the subheadings or when you work with footnotes.

When using an anchor link, make sure that the Text format set for the Body editor is Imported HTML.

Start at the spot that you want to link to and place your cursor, for instance, in front of the first subheading. Then click on the anchor symbol (flag) on top and provide a name for the anchor, for instance, subheading 1. Go back to the place where the link is to be placed, for instance in the table of contents at the beginning of your text, and mark the text to be linked. Choose Link Type Link to anchor in the text and pick your anchor name from the list below. In this case the anchor name was subheading 1. Click OK.

When users now click on the link Subheading 1 in the table of contents, they will be taken to Subheading 1 in the text.

There are more formatting options in your Body Editor. For instance, you can create numbered or bulleted lists. Notes (such as editor's notes) have to be made italic font. The same applies to translation information and the date of the initial publication at the end of the text.

Step 6: Assets and Media

Under the body, there is the Assets and Media section. It can be used to attach files (such as pdf, pptx etc.) and to embed external media such as audio and video, image galleries or additional images, charts or tables. These features are explained in extra How-To's (see links).

Step 7: Categorizing and tagging

Now it's time to assign the article to the respective categories.

  • Haven: The information provided here determines which menu tab will be highlighted together with the article.


  • Haven Topic/Region/Institution: These fields don't play a role for the international office sites.
  • Format: Here you can opt for the article format. You can choose more than one option. All articles should be formatted as "article". If you - later on - want to provide lists such as "All interviews on ..." or "All documentations on ..." you can add "Interview" or "Documentation"
  • Topics: If this field is shown, international offices can ignore it.
  • Region: If this field is shown, international offices can ignore it.
  • Institution: If this field is shown, international offices can ignore it.


Tags: Here you can tag your articles. The tags will be shown in the sidebar alongside with the article. When a user clicks on a tag he/she will be taken to an overview page showing all articles tagged with this tag. This is a useful function on our sites. You can provide multiple tags for an article. They should be comma-separated. Please pay attention to a consistent spelling of the tags and avoid double-tagging such as "Peace" and "peace", for instance. When you type slowly, the system will show existing tags. Attention: Editors of the international offices are not allowed to edit the tag lists. If you find double or misspelled tags contact the support.

Related Articles (Contents): Here you can search for texts which are additionally displayed to an article in the sidebar. When you type the title, the system will suggest a list of existing articles and publications.  If you want to link to external contents, you will have to do this within the text (see step 3).

Authors: Here you can name the author(s) of the article. This is only possible if the author's profile (person node) has already been created. If there's no profile, create one. Here you can learn how to do this.

License: This is important, however often forgotten. Here you provide the license of the text. Articles written by the hbs-staff are usually licensed CC BY-SA (whereas texts, especially publications,- which represent the foundation as a "brand" will be licensed CC BY-NC-ND). If you don't know how to deal with licenses, please have a look at this article.

Step 8: Publishing

Before you save the text, decide whether to show it in automatic lists. Sometimes, for instance when the article is part of a dossier, you might not want to do this, because all the dossier articles would show up as latest articles on top of your homepage and you might rather want to place them elsewhere, manually. To avoid an article becomes part of a list, open the ADMINISTRATION section and change the default setting to Hide in views:

Now you can save the text. Though it is not yet published, you can see how it will look like. Proofread it and check the links.

Click on Edit. You will be taken back to the editing mode. If everything is correct, scroll down, click on the button Publishing Options and tick Published. After completion, logged-in users will immediately see the published article. For all other users this can take a few minutes.