Gecko v7 Gecko v7
  • +44 (0) 131 240 3390
  • +44 (0) 131 240 3390
  • Gecko Agency
    Design
    Brand Strategy
    Web Design
    Development
    Umbraco
    Custom API Integrations
    Custom Web Development
    Virtual Website Planning
    Digital Marketing
    Search Engine Optimisation
    Paid Search Marketing
    Content Marketing
    Social Media Marketing
    Support
    Support Packages
    Blog
    Case Studies
    About Us
    Careers
    Contact
    Edinburgh

    Best Practices for Content Editing in Umbraco

    (That No One Told You About)

    9th May 2025

    A lot of the time when we hear “the CMS just isn’t working,” the issue isn’t the platform – it’s the content going into it.

    CMS platforms like Umbraco do exactly what they’re told. So if the formatting’s off, the headings are messy, or the layout feels clunky, the results will be too – no matter how good the system is.

    It’s not about doing it wrong – it’s about not knowing what to look out for. The stuff that often gets missed once training’s over and the real-world edits begin.

    So, we’ve put together the guide below – along with sharing the internal checklist our own team uses – to help fill in those gaps when we're updating content for our clients. These are the small, behind-the-scenes content habits that make a big difference when it comes to keeping your site tidy, consistent, and working as it should.

    Want a copy to keep or share with your team?

    Download our step-by-step content checklist - the same one we use at Gecko. And if you ever feel like your team could use a quick refresher on Umbraco or content best practices, we’re always happy to jump back in with a top-up training session.

    DOWNLOAD THE CHECKLIST

    The Step-by-Step Guide to Getting Content Right

    Whether you're updating a few lines of copy or building out a full page, these are the steps we follow at Gecko to make sure content is clean, consistent, and ready to perform.

    1. Scout the territory before you dive in

    Before you paste anything into the CMS, take a look at what’s already on your site. Find similar pages and match their structure, styling, and layout so the user experience stays consistent.

    Check which components those pages use to present different types of content – and use the same ones where it makes sense. It’ll save you time, reduce guesswork, and help everything feel seamless across your site.

    2. Polish your copy (even if you didn’t write it)

    Even if your content has already been written or signed off internally, that doesn’t always mean it’s ready to publish. A stray typo or clunky sentence can make even strong messaging feel unpolished – and once it’s live, it reflects on your brand. A quick proofread is always worth it – especially when it's your reputation on the line.

    Use tools like Grammarly, Microsoft Copilot in Word, or Google Gemini in Docs to catch errors before they catch your reader.

    3. Copy and paste without the chaos

    Copying straight from Word or Google Docs can drag in a mess of formatting - extra spaces, weird fonts, broken layouts.

    Always paste as plain text (drop it into Notepad first if needed), then apply styles using Umbraco’s built-in Rich Text Editor. And please, no inline styles unless you’re absolutely backed into a formatting corner!

    4. Structure with purpose: use headings properly

    Headings aren’t just for decoration - they’re key for accessibility, readability, and SEO. Follow this basic rule:

    • H1 - This is you main page title. There should only ever be one H1 per page. Make it count – it tells users (and search engines) what the page is about. Ensure it’s clear, relevant, and matches what someone might search for or expect to see.
    • H2 - Use H2s for main sections of your page. Think of them like chapter titles. They introduce new topics and help break content into logical chunks, improving both readability and accessibility.
    • H3 - Use H3s for content that sits within a section – they break down your H2s into smaller, more specific parts. This is especially useful when a single section covers multiple ideas, processes, or examples.
    • H4 - Use H4s when your H3 sections need even more clarity or structure. They’re great for adding detail or breaking up dense information – just make sure you're using them logically, not just for visual styling.

    If you’re dealing with a wall of text, break it into multiple RTE widgets and give each one a clear heading. It makes things easier to edit, scan, and rearrange later.

    5. Think about SEO (yes, even for small edits)

    Every update is a chance to improve your site’s visibility in search engines. Don’t skip the behind-the-scenes stuff:

    • Add or update meta titles and descriptions
    • Set up share information - title, description, and a strong image
    • Check your previews with a social share tool (we recommend the Social Share Preview Chrome extension)

    These small steps make a big difference when your page is shared or indexed.

    6. Ditch “click here” for good

    Let’s fix this once and for all. Avoid vague links like “click here to read more”. Instead, be descriptive:

    • “Click here to learn more about Gecko Agency” becomes
    • “Learn more about Gecko Agency’s approach to Umbraco Development”

    This helps with accessibility, SEO, and general professionalism. Plus, screen readers will thank you.

    7. Don’t hit publish and walk away

    Once the page is live, do a full sweep. Check that:

    • Everything looks right on desktop, tablet, and mobile
    • All internal and external links work properly
    • There are no weird spacing or layout glitches
    • The URL is clean and concise (not just a long page heading)

    Publishing is not the end - it’s the checkpoint.

    8. Manage media like a pro

    Images can slow down your site - or make it shine. So:

    • Keep images under 100kb where possible
    • Name files clearly and logically
    • Organise media folders (no more “misc” or “new”)
    • Add alt text to every image for accessibility

    9. No half-baked pages allowed

    We’ve all been there - someone clicks “Save and Publish” a bit too early, and suddenly an unfinished page is out in the wild.

    Never publish incomplete pages. Draft it, preview it, tweak it - but only go live when it’s 100% ready.

    If you need to share it with a colleague for review, no problem. Our Umbraco sites include options to hide pages from navigation and search engines, so you can make a page live without making it public. That way, your half-baked draft stays safely behind the scenes until it’s ready to go.

    How We Keep Content Sharp at Gecko

    The best practices in this blog give you a flavour of how we approach content editing at Gecko – but the checklist goes deeper. It includes all 25 checks we follow every time we update a site, so you can apply the same level of care and consistency to your own content.

    And if you ever want a refresher on content editing or Umbraco training for your team, get in touch, we’re always happy to help.

    Let’s keep your content doing the heavy lifting - and your CMS working like a charm.

    Grab the full Gecko Content Checklist

    A clear, step-by-step version of everything we’ve covered – including all 25 checks – ready to use every time you update your site.

    DOWNLOAD THE CHECKLIST

    9th May 2025 Share This:
    ...
    Author
    Michelle
    Marketing Assistant
    Michelle, our talented Marketing Assistant, loves spending time in nature and exploring the great outdoors. She also enjoys spending time with family and friends when she isn't off exploring! Michelle is passionate about learning new things and embracing opportunities for growth, as well as being a great lover of Avicii and EDM music!
    Follow Us:

    Gecko Agency (Edinburgh)

    hello@wearegecko.co.uk
    t: 0131 240 3390

    t: 0131 240 3390

    Head Office

    Orchard Brae House
    30 Queensferry Road
    Edinburgh
    EH4 2HS

    Gecko Agency Ltd | Copyright © 2025

    • |GDPR
    • |Privacy Policy
    • |Cookie Policy