FAQ Category: editing tips

About WordPress

Your website is built using WordPress, a free, open-source, website platform used by thousands of people worldwide. WordPress is actively developed and maintained, so updates are frequent, and new features are added all the time. This also means that support resources and documentation for WordPress are numerous and easy to find in comparison with other platforms.

The main documentation site for WordPress is called the Codex, it can be found here https://codex.wordpress.org.

Although the Codex caters for advanced users and developers, it also has beginner-level guides relating to editing content. You can start here https://codex.wordpress.org/WordPress_Lessons and browse the pages. Please bear in mind that every WordPress site is a little different, and features on your site may not be part of the ‘core’ WordPress – they may be created using plugins, or bespoke code, in which case they not be covered by the Codex explicitly.

Getting started

The login page for you website is at http://eastridingarchive.com.testing.sites3.default.peterpavement.uk0.bigv.io/wp-admin
If you have forgotten your password, go to http://eastridingarchive.com.testing.sites3.default.peterpavement.uk0.bigv.io/wp-admin.php?action=lostpassword and follow the instructions. Please note that these are the development URL and will change when the site launches.

When you’re logged in, the first thing you will see is the Dashboard – this is a summary page for your WordPress installation. It can be customised, but by default it should show things like Recent Activity, and WordPress News.

The most important part of the user interface (UI) is the bar on the left. This is the main navigation for the WordPress back-end. It has a list of several sections, beginning with the types of content on your website:

  • Media
  • Pages
  • Points of interest

It then has links to WordPress settings, Appearance options, User settings, and custom plugin options. Be careful with changing settings – if you’re not 100% sure what something does, it may be best to leave it alone. Editing content is a lot more flexible and forgiving, there is very little you can ‘break’ just by editing content.


Users are people who have access to the back-end or admin part of your website. If you do not see a specific option, bear in mind that only users who have a role of Administrator can change important settings. Users who are Editors can usually only edit content. This control is set up in Users, where new users can be added, and existing users can have their role changed, password changed, etc.

Types of content (post types)

It is important to have a good understanding of the available content types in your WordPress before making changes, or more crucially when adding new content. Almost every WordPress site we make has its own bespoke set of content types (or in WordPress lingo – post types). The main default content types are Posts and Pages. The difference is sometimes a bit tricky to understand, aside from the name, but Pages are usually ‘static’ types of content that are are individual stand-alone resources, they do not usually share common data. General articles about your organisation will usually be set up as Pages. On the other hand, Posts are more flexible, but generally used for things like Blog pages and News items. Posts can also be highly customised, and may have much more going on than just an article of text. Posts can also have Tags and Categories – these are a type of Taxonomy, which is a fancy name for classification, or categorisation.

In addition to Posts and Pages, your website may have custom post types set up. These are even more customised versions of Posts, so customised they have their own name and rules. They have different fields (places to add data) and are being used in specific and unique ways.

Please note that the content types do not necessarily correspond exactly with the front-end navigation, i.e. posts of the same type may be output in different sections of your site on the front-end.

Adding points of interest

Add the trail points of intest by selecting ‘Points of interest’ and then ‘add new’. The following content is to be added for each point of interest:

  • Title and extended copy
  • longitude and latitude coordinates
  • Direction information, multiple steps can be added here by adding new rows
  • The activation distance in metres for a notification when the user is close to this point
  • Select the trail tag to link the point of interest to the trail
  • Add supporting and featured images

Adding Trails

To add or edit and existing trail go to ‘Points of interest’ and then ‘trails’. The content for each trail is as follows:

  • Trail name
  • Trail description copy. This is displayed in the inital trail information screen
  • Subtitle – this is displayed under the trail name in the inital trail information screen
  • Time in minutes and distance in miles
  • Upload a route .kml file. These can be created here: https://support.google.com/mymaps/answer/3433053



Writing for the web

  • It is ideal to have a consistent tone of voice across all copy on a website. This creates continuity and prevents the content and organisation appearing fragmented. If there are a number of people with editorial rights to the site, you may like to have one or two central people to run copy through/sign it off to help maintain the organisation’s voice.
  • Use consistent formatting when laying out text (i.e. using headings, subheadings, making text bold etc) it is best to have a standardised way of doing this.

    Meet the user need

  • Always keep your audience in mind when creating copy for your website. Try to think about what they would want to get from the site and what tone of voice is suitable for them. 
Your writing will be most effective if you understand who you’re writing for.
  • To understand your audience you should know:
    – How they behave, what they’re interested in or worried about – so your writing will catch their attention and answer their questions
    – Their vocabulary – so that you can use the same terms and phrases they’ll use to search for content
  • When you have more than one audience, make your writing as easy to read as possible so it’s accessible to everyone.
  • Don’t publish everything you can online. Publish only what someone needs to know so they can complete their task. Nothing more.
  • People don’t usually read text unless they want information. When you write for the web, start with the same question every time: what does the user want to know?
  • Meeting that need means being:
    clear and to the point
  • Avoid ‘walls’ of text – break up your content into easily- digestible chunks, and use headings to create sections that humans can easily understand and take in. This is also great for search engine optimization (SEO) because headings (titles) and subheadings (summary) have greater importance than normal paragraph text for search engines. Try to think about what they contain and make the content meaningful and refer to key points of the paragraph text.
  • Good online content is easy to read and understand.
    It uses:
    short sentences
    sub-headed sections
    simple vocabulary
  • This helps people find what they need quickly and absorb it effortlessly.

    Headings and titles

  • Keep in mind 65 characters or less (including spaces). This is because search engines truncate (cut off) titles in Google search results over that number. Words or parts of words will be cut off.
  • Make sure your title is unique. It’s not helpful for people if search results show a list of pages with the exact same title.
  • Titles should be clear and descriptive. The title should provide full context so that people can easily see if they’ve found what they’re looking for
  • Front-load your titles. The most important information and the words the user is mostly likely to have searched should be at the beginning of the search result.

    How people read content on the web

  • Users read very differently online than on paper. They don’t necessarily read top to bottom or even from word to word.
  • Instead, users only read about 20 to 28% of a web page. Where users just want to complete their task as quickly as possible, they skim even more out of impatience.
  • Remember that the pressure on the brain to understand increases for every 100 words you put on a page
  • Web-user eye-tracking studies show that people tend to ‘read’ a webpage in an‘F’ shape pattern. They look across the top, then down the side, reading further across when they find what they need.
  • What this means is: put the the most important information first. For example, say ‘Canteen menu’, not ‘What’s on the menu at the canteen today?’
  • Avoid the urge to always state the name of your organisation as the first word(s). This helps people identify the most important information to them as they scan quickly through the page and is good for SEO.

Style guide

  • It is best to decide up front the tone of the site so it remains consistent – this can differ in different sections, for example a blog post or story feature can be more conversational and from the first person.
  • For consistency, decide on preferred formats, terms and conventions for commonly used content e.g:- Dates (e.g. 25th Nov 2017 or 25/11/17)
    – Times (12 or 24 hr clock)
    – Period dates (e.g. 19th Century or 1800s)
    – Measurements & units
    – Pricing / costs (£1 or 1GBP)
    – Wars (WW1 or First World War)
  • This should follow what is in your print and promotional material
  • Make sure everyone who is contributing to the site is aware of these.


  • Images should ideally be no less than 2000px on the shortest side. It’s best not to go below this size so that the image remains at good quality for high retina screens. Images for the web must be in .jpeg, .png or .gif format
  • Avoid using ‘rogue’ characters in file names. When saving any image or document for use on the web you should not include any characters other than those from the alphabet (lowercase) and underscores (_) – this includes spaces. If you do include characters such as spaces or & or , in file names this may cause problems displaying them.
  • To insert an image click the ‘Add Media’ button at the top left of the editing panel.
  • The ‘featured image’ is usually the image that will be the main ’chosen’ image to represent the trail and will appear in any listing pages.
  • Featured Image is usually found at the bottom right of the editing page.
  • When selecting ‘Add Media’ or ‘Set featured image’ you will see a library of all the media (images, sound files, video files) you (and everyone else) have uploaded so far.
  • You can either select an image from the library or upload a new one from your computer.
  • Although the media library isn’t ordered you can search for images using the search box. The search will look for any text associated with that image, so filling in the title and alt text field is really useful for this.
  • Click ‘insert into page’ or ‘set featured image’
  • When the image is in the page you can click on it it to reveal some editing options which appear at the top, this allows you to make some basic edits to the image e.g. left, centre or right align the image:
  • Clicking the pencil icon will bring up some more editing options such as resizing the image.
  • There is a drop down list of built in image sizes under ‘size’ – often when you first insert an image into a post it is too small, so it is a good idea to check this and make sure it is set to the appropriate size for the page.
  • Linking images– Always link to ‘Media File’. This means when an image is clicked it will show a larger version of itself in a responsive modal window.
  • Image alt text is used by screen readers to describe an image to people with visual impairments when having a website read out aloud to them. Without alt text the screen reader just reads the word ‘image’ when reading the webpage. As you can imagine this can be very frustrating for the user. There is a field in the media library called ‘Alt text’ – you will see this on the right hand side when an image is selected. Enter your description of the image here. Search engines will mark the site down if the alt text field is left blank.
  • You can also edit the alt text by clicking on the pencil symbol.
  • Image copyright – add to the copyright field when uploading images.
  • Image borders – Images will have a white border added to them so do not add images which already have one as part of the picture.

How to create accessible content

When a website is designed with accessibility in mind and built correctly to be inclusive to everyone, users will have equal access to its information and functionality. A site that is not built accessibly will present barriers to people with disabilities that prevent them from accessing the content or using the site at all.

So when you’re creating content for a site – or updating a current website’s content – it’s useful to know what the most common barriers to access are, so you can avoid them.

The following information is thorough and therefore we have included points that will be controlled by the coding of the website (e.g. the text size and colours) but it is useful for you to be aware of.

Eight Most Common Barriers to Access

The Web Content Accessibility Guidelines (WCAG http://www.w3.org/TR/WCAG20/) has 65 checkpoints. Research has found that 82% of access problems are related to 8 of these points – some of which will affect the creation of content. We’ve included all 8 barriers here as they help to explain a little about how people with disabilities use the web:

Divide blocks of information into more manageable units

Check all the text and try to make it clear and conciseand avoid long, wordy passages.

You can divide the info upby adding photos and images, and organise it into subject areas and use headers. Breaking it down into smaller chunks will also make it easier to digest.

WHY: adding headings and splitting the text into smaller chunks make content easier to understand. Many users (including those with reading difficulties such as dyslexia or those with visual impairments) will find long and wordy passages hard to wade through – breaking it down will help them and many others to understand what you’re trying to say.

Add an overview to every page: add a short description at the start of each page saying what the section is about, to help give the user an idea of what the main content is and what their main options are. 

WHY: some users can’t glance at or scroll around a page to get an idea of what’s there (e.g. if they’re a blind screen reader user or using adapted hardware due to restricted movement). One or two lines about what’s on this page will help clarify what’s coming up and decide whether to spend more time on the page or not. It’s a quick snapshot of what’s coming up in case they can’t see or process the visual information themselves, and will save them time and energy of having to move around slowly and work it out for themselves.

Increase ‘leading’(space between lines of text) – it’s harder to read blocks of text when the lines are close together.

WHY: increased space between lines improves legibility for everyone.

Ensure that foreground and background colours have sufficient contrast

Contrast between text and background colours needs to be high to provide good contrast

Another point related to overall legibility (rather than colour contrast) is to ensure that a clear fontis usedthroughout, and some effects such as italics are avoided – many partially sighted users find these effects harder to read.

WHY: increased colour contrast and clear font choices makes it easier for users with reading difficulties to read. Conversely low contrast, such as grey text on a beige background, make it much harder to read.

Avoid creating pop-ups and new windows without informing the user

If any content opens in a new browser tab or window it’s polite to inform usersthis is about to happen so they know what to expect.

WHY: if the user isn’t told that a new window is about to open up, they can get ‘lost’ within that window and not know how to get back to the original site. This is especially frustrating for some assistive technology users, e.g. a blind screen reader user won’t know that they’ve moved to a new window and might become stuck there or at least frustrated that they have to work their way back.

Provide a text equivalent for every non-text element

Add captions and descriptive alt textto all photos, images and maps used throughout the site.

WHY: Adding information and alt text to every image makes visual content more accessible to partially sighted magnifier users and blind screen reader users as well as compatible with other assistive technologies. A short text description of an image can unlock the information within a picture and enrich the experience and understanding of a story for users – alternatively, without it, images will be inaccessible for blind and partially sighted users. Related to this, images do help to liven up the content, but ensure that images used as simple and with high contrast if possible.

Add captions and transcripts of the audio elementof all videos and any audio clips. It would be even more useful if you could also provide transcripts (the written script) of written or spoken content. To make video accessible to BSL users, it’s also good practice to include at least an introductory ‘welcome’ video with BSL. This would give BSL users an initial flavor of the site and venue – and feel welcomed by them.

WHY: adding captions and a transcript increases accessibility of any written or audio content for everyone, including Deaf or hard of hearing users, or users trying to understand the content without access to speakers or in a quiet environment. As a minimum, add a link to a transcript which outlines all the spoken and audio and visual content within video or audio files. This enables any user to review it separately or makes is easier to copy and share information.

Clearly identify the target of each link

Ensure all links are consistently labelled, that they look suitably different to the normal body text and that they look like links. Avoid labelling links as ‘here’ or ‘click here’ as out of the context of the page they don’t tell the user anything about where they’ll lead them.

WHY:links need to make sense even if they stand alone, as many assistive technology users will short-cut to a list of links on a page as a way of getting a quick impression of what content is available on that page.Making links look consistent follows standard conventions for navigation and will make the site as usable and accessible as possible, as users will know what to expect as they explore the site.

Review how the main menu options are presentedand simplify them where possible. Keep the top menu bar as uncluttered as possible (as well as the further drop-down options). Options need to be separated out very clearly to make them easy for users to differentiate.

WHY: we should simplify navigation options as much as possible, adding lines between each of the options to help users to see more clearly what the different options are. Without them the options will potentially all run together (especially for those with reading difficulties or those who are partially sighted). There are other ways of helping the user to work out where they are on the site and to keep their thread, including the use of a crumb-trail.

Use the clearest and simplest language appropriate for the site’s content

Where possible use clear and simple languageto make it as easy as possible to understand, and avoid using jargon. You could include some content in Easy Read format, which was created to make content more accessible for users with learning difficulties, e.g. see some examples on the BILD site (British Institute of Learning Disabilities): http://www.bild.org.uk/resources/easy-read-information/

Use a large clear font– in terms of font size, a lot of the text on the site is too small. Ensure that the default font throughout the site is larger.

WHY: increasing the font size will make the text easier for everyone to read, and will be essential for people with reading difficulties. Some users will need to make it larger still so all text needs to be scalable.

Ensure that pages work when scripts and applets are not supported

A site shouldwork independently if Java Script or applets are switched off/not supported.

Related to this, I recommend that clients explain very clearly how to change any in-built accessibility featuresthat are included on the site, and add some information about how to adjust different devices to increase accessibility – via a link to an Accessibility Options section.

WHY: accessibility options or controls built into websites vary a lot, so it’s helpful to list any features that have been included so the user knows that they’re there and how to use them, e.g. how to adjust the font size or change the background colours and colour contrast options. It’s also good practice to include a contact email or number for users to send any accessibility feedback or suggestions, to demonstrate that you see accessibility as an ongoing process and are looking for how to support your users as well as possible.

The Accessibility sectioncould include: a list of the access features on the site, suggestions for how to adjust settings and an appeal for feedback from users.  I suggest adding this content via a link which appears prominently on the site (e.g. via the top menu bar) – there are many examples of how to present this information, e.g. see the Brighton Museums Web Accessibility page:   http://brightonmuseums.org.uk/about-us/policies/accessibility/web-accessibility/

Avoid movement until it can be frozen.

e.g. A moving image slider on the home page is a barrierto access, as it can’t be paused.

WHY: research from user testing has found that many users, including those with learning difficulties and reading difficulties, can find a sliding carousel of images very distracting and reduces their ability to understand the content. At a minimum it needs to be clear how to pause this moving content.