Skip to main content

How to create and edit the 'HTML document' content type on GOV.WALES.

First published:
11 December 2019
Last updated:

When to use

Before you create or edit content, you need to read and understand:

You should also have a version of the content ready for publication. An HTML document will usually be split into sections with headings.

Use for: 

  • an html version of a publication

How to create

Creating a new HTML document

  1. Log in to GOV.WALES and LLYW.CYMRU.
  2. Select the Workbench view in GOV.WALES (you must start on the English site).
  3. Select Create content.
  4. Select HTML document.
  5. Complete the Title field.
  6. Complete the Summary field.
  7. Select Add Content Section.
  8. Complete the Section title field.
  9. Select Add Content and paste content into the Content field.
  10. Repeat steps 6 to 8 for more content sections.
  11. Tag to relevant Topics.
  12. If content is from or about an organisation complete EXTERNAL ORGANISATIONS with the name of the organisation.
  13. Add up to around 5 INTERNAL LINKS (NODE) to content directly related to the users needs being met by the HTML document.
  14. Do not usually complete INTERNAL LINKS (TERMS). Either the HTML document is relevant to a topic therefore tagged to it or linked to pages meeting specific user needs.
  15. To link to another website select Add External Link.
  16. Uncheck Generate automatic URL alias.
  17. Specify an appropriate URL alias, based on the title of the document, and add ‘-html’ to the URL alias. Follow naming files and HTML documents for advice on creating URL aliases.
  18. Check the First Published and LAST UPDATED dates under AUTHORING INFORMATION.
  19. Select Save and Create New Draft.
  20. To add the Welsh content, select TRANSLATE.
  21. Select Add from row labelled Welsh.
  22. Update fields with Welsh language content.
  23. To save changes without making them public select Save and Create New Draft (this translation). To save and make changes public select Save and publish (this translation).
  24. Publish the Welsh and the English and check both languages, for example layout is correct and links work.

Editing an existing HTML document

  1. Log in to GOV.WALES and LLYW.CYMRU.
  2. Find the existing HTML document either by browsing the public site or select Workbench then All recent content. You must do this on GOV.WALES as the English content must be edited first.
  3. Open the HTML document.
  4. Select EDIT DRAFT or NEW DRAFT.
  5. Edit the HTML document.
  6. Complete Revision log message (all languages) with brief summary of changes.
  7. Change the LAST UPDATED date under AUTHORING INFORMATION. Steps 6 and 7 are only for content changes. Do not use for typos and format changes.
  8. To save changes without making them public select Save and Create New Draft (this translation). To save and make changes public select Save and publish (this translation).
  9. Make the same changes to the Welsh version of the HTML document.

Components available

Lists which components are available and how to use them if they are allowed.

Paragraphs: content section

Use the content section paragraph to break up longer pages with headings.

Paragraphs: content

You must use the content paragraph for the majority of the page content.

Paragraphs: accordion

Do not use accordions on an HTML document. 

Paragraphs: related links

Do not use the related links paragraph on an HTML document.

Paragraphs: call out message

Do not use call out messages on an HTML document.

Paragraphs: contact details

Follow the contact details definition to add contact information, for example a telephone number.

Internal links (node)

Use to link to around 5 pages directly related to the users needs being met by the HTML document.

Internal links (terms)

Avoid using internal links (terms). These links are to topics and usually the most relevant topic is already found by the breadcrumb.

External links

Follow the sidebar links definition to link to content directly related to the user needs met by your content.

Share this page