Iceclog Editor Guidelines: Writing Compelling Posts

Martijn Hoogeveen
By
August 17, 2016
wall-writer-in-action

Freeimages.com/Davide Farabegoli

The Iceclog Editor Guidelines are a quick guide for contributors to the Iceclog blog or “clog” (content log) as we like to call it. Take first care that you understand the Word Press (WP) editor that we use. Make sure that you post great content worth reading. And finally, look into adding the footage to make your post attractive.

Before you start working on blog posts, take care to upload a profile image, and check your name, as these are the details that will appear next to your posts.

WP editor tips

Regarding the simple blog editor in the WordPress Dashboard, a few things are important:

In Visual mode you have a simple HTML-editor in WYSIWYG (What You See Is What You Get) mode. In Text mode, you see the markup codes as they are included.

If you write a post, use the Visual mode.
If you paste text from somewhere else, use the Text mode or Paste As Text toggle, to make sure that you are not unwittingly copying markup (html code) that might disrupt the Iceclog templates.

Use the Toolbar Toggle icon above the body of the editor, to show other common icons. Read also some basic tips for WP editor users.  If you use external links, consider to activate the advanced  option that the link is opened in a new tab, in case that you think that your reader would like to continue reading afterwards. In case of links, make sure that you use a public link to an international version of a source site, thus without being logged in.

We use Paragraph for normal text. And,

We use Heading 3 for the headers in the text.

And Heading 4 for sub-headers in the text

Use featured image (right button) for uploading an image that will be shown as an appetizer for your post (above your post).

Don’t start the blog text with a header or a link, as it will disturb the layout here and there on the website.

Use as little further markup as possible: bold is reserved to headers. Italic can be used to stress certain keywords or keywords that come from a foreign language. Don’t use underline, as it is commonly understood as a link.

TIP: use the Blockquote icon for tips, quotes or messages that need to stick

If you really need a table, you can insert in Text mode, the standard HTML tags, where <tr> .. </tr> creates a new table row. If you can avoid a table, better do so.

<table width="100%" cellspacing="0" cellpadding="0">
<tbody>
<tr>
<td valign="top" width="30%"><b>First column header</b></td>
<td valign="top"><strong>Second column header</strong></td>
</tr>
<tr>
<td valign="top">First line, 1st cell value</td>
<td valign="top">First line, 2nd sell value</td>
</tr>
</tbody>
</table>

TIP: You can alternatively include a table as an image

Take care that your post is assigned to one or more correct Categories, such as News, Stats, Reviews or other. Don’t create new Categories without consulting the Blog Editor, because Categories will show up in the browsing interface.

Choose a few of the most important key words (as tags), but don’t overdo it. If we publish the tags it shouldn’t become a crazy list of clickable key words. For SEO (Search Engine Optimization) it helps a bit to repeat keywords, but the metatags for those keywords are ignored by Google. Best to repeat the keywords as they appear in the text.

Copywriting Compelling Texts

Look at how great journalists write their posts in great magazines. The title gives the compelling message, the summary of the text in a few words, not a static classification.

The first section, expands on the title and is like a longer summary. The following section is expanding the story in full detail. Some repetition of text between title, summary section and the full text is quite common. But, in every repetition more detail is added. This redundancy helps the reader to quickly navigate through the text and manages the expectation. If you drop headers, make sure the header is not just a passive noun, but something that gives a message, often by adding a meaningful verb, adverb and/or adjective. (For example: not “Image”; better: “Image Size Matters”).

Another tip is: a good blog doesn’t read like an advertisement. The text is objective, fact-based. If you state “video improves shopper conversion” at least three references to independent sources that support this statement with facts are needed. Trust that a good read is what people love, they will appreciate you for that and might read your next post as well. Finally, don’t talk about yourself (your company) all the time. Talk about a client case, the market, users, buyers, technology trends, products, product data, PIM developments.

Finally, make sure that you add something that is new for the reader. It can be a new angle (analysis) on the subject. It can be new facts. It can be that something is news, which means that you are the first to break it to your audience.

What should be the size of my blog? 500 words is the size of a “column” in a paper. It’s a good approximation. A news post can be smaller. A manual will be much longer. In case of manuals, think of how to break them down. For example, by cutting out repeating sections that are shared by other manuals.

O yeah, about the use of abbreviations. Don’t assume that your reader knows them. So, unless they are really widely adopted by kind of everyone, write them out the first time in full, with the abbreviation between brackets or the other way around. In this text, you can find a few examples, where I assumed HTML is so widely used that it is known by the reader.

Readable texts

There are many advises for writing readable texts. A number of typical “mistakes” are listed here

  1. For numbers below ten, use the word. So, write “eight” not 8.
  2. Write direct and in present time, it’s easier to digest. So, don’t say “I would have gone there, but they had insisted that I should stay at home”, but say “They keep me home”. Just four words in stead of 15!
  3. Variety: use a mix of shorter and longer sentences.
  4. Use speech language, not formalistic language, but keep it decent.
  5. Be consistent in the time and style you use. Don’t switch from “they” to “you” and from “we” to “I”. And keep the time as much as possible the same: not was and is mixed up randomly.

Image size matters

Upload of images (media): use Irfanview as it has a great function for saving images for Web in a strongly reduced size. Using it saves for Web menu option. Remember: bigger image files slow down the browsing experience of your post and the blog considerably. An image can be shrunk to less than 100KB, and still be detailed.

TIP: if your image size is much larger than 1024 pixel, resize it first. This will reduce the image size (KBs) a lot.

Take care that the file name of the image is meaningful, because the file name will be somewhere in the html of the blog, and will be interpreted by Google. F.e., if you show an image of woman with a hat, call the file “Woman_with_hat.jpg”. Also don’t forget to enter other details for the image (media) you upload, such as title. Fill in the Alt field, as it will be used for populating the Alt tag, the popup explanation per image on mouse-over. Such details improve our SEO.

Last but not least, unique images are better than standard images. If you use standard images, make sure you use a copyright-free image, or secure that you obtain the permission from the copyright owner. In case you use a free image, make sure you include a correct credit (see the bottom of this page for an example). Better, is of course to shoot your own footage or make a screendump or artistic impression.

In case of screen dumps (Prtsc): cut off the sections that are irrelevant for your narrative. For example, a screendump of the Icecat website shouldn’t contain the Icecat logo, as that would then be repeated in the blog itself and that might look a bit ugly.

FInally, when inserting the image take care that you indicate  if WP is including the image with its original size or resized to a smaller version.

Embed rich media

You can use the embed code of Icecat to embed certain compelling rich media such as videos. Ask the editor if you have questions about that!

Double Check before you Publish

Re-read your own post many times, use a spellchecker, and ask the Editor to check your post before it’s published. Also, always good to have a colleague or friend to read your post before you submit it, as every posts contains mistakes or things that can be clarified or improved.

You can use the status Draft or Pending Review for this. The Editor will take care of publishing your post. If you want to get notified by email, subscribe to the blog on the frontpage.

Dare to Share

Share your own post with your colleagues, clients in newsletters, with your friends on Facebook, relations in Twitter, LinkedIn, G+ or any social media that you use frequently. Twitter is in general more a PR (public) medium, as is G+. LinkedIn is more a professional sharing network. But, also Facebook is more and more becoming a mixed private & business media. So, dare to share, it might lead to unexpected responses.

Stock image: Freeimages.com/Davide Farabegoli

Likethumbsup(7)Dislikesthumbsdown(0)

Leave a Reply

Your email address will not be published. Required fields are marked *

Manual for Icecat Live: Real-Time Product Data in Your App

Icecat Live is a (free) service that enables you to insert real-time product content from some 300 m...
 June 1, 2016
World map

Iceclog Launch and Improved Icecat LIVE Documentation

“Iceclog” (Icecat content-log) is our new blog, where you will find...
 August 26, 2016
http url

Manual for Icecat URL: Links to Product Data-sheets and Images

Version: 1.20, October 4, 2016. The purpose of this post is to explain the Icecat URL method to ...
 October 4, 2015

Manual for Icecat CSV Interface

This document describes the CSV (Comma-Separated Values) variant of Icecat's Open Catalog Interface...
 September 28, 2016
apple_watch_series1

Apple Watch: a Useful Tool or a Smart Toy?

After six months spent with my Apple Watch, I am still not sure if I consider it a useful tool or "j...
 September 30, 2016

Manual for Testseek Product Reviews Integration via Icecat

Icecat provides aggregated expert reviews from our partner Testseek, as an add-on service for both O...
 October 19, 2015

Manual for Personalized Interface File and Catalog

Via the Icecat website and login area, a user can generate personalized or customized CSV or Excel f...
 October 5, 2016
wall-writer-in-action

Iceclog Editor Guidelines: Writing Compelling Posts

The Iceclog Editor Guidelines are a quick guide for contributors to the Iceclog blog or "cl...
 August 17, 2016
Interview radio Lets talk business

Interview Icecat CEO by Newbusinessradio.nl about IPO

Ron Lemmens of Newbusinessradio.nl/Let's Talk Business interviewed Icecat CEO Martijn Hoogeveen abou...
 November 23, 2016

FAQ for Brand Owners

Icecat is an independent global syndicator of rich product content. In...
 October 19, 2016

Manual for Open Icecat JSON Product Requests

JSON (JavaScript Object Notation) is an increasingly popular means of transferring to data, comparab...
 February 17, 2017

Icecat Add-ons for Popular Solutions

Icecat has a huge list of integration partners, that make it easy for clients and free users, to mak...
 February 4, 2017
top10_tomtom_cats_q2_2016_2015

TomTom re-entered Icecat top 100, in flux towards action cameras

TomTom is a brand in change, which re-entered the Icecat Top 100, as all its fast-growth categories,...
 August 2, 2016
Field notes by Beth Kinder

10 Tips for Successful Integration of Icecat Data

Based on the experience of thousands of Icecat and PIM implementations, I distilled the ten most cr...
 August 29, 2016

Open Icecat Fair Use Policy

A user of Open Icecat will conform to this Open Icecat Fair Use Policy and do its best to avoid to h...
 October 2, 2015

Quick Guide for Real-Time Data (xml, csv) Requests

Because of the size of index files, it is in many cases advised to use real-time data requests. Thi...
 October 20, 2016
Icecat is National Champion in European Biz Awards

Icecat Nominated as “National Champion” by European Business Awards

Icecat NV has been nominated by the European Business Awards (EBA), within the category of busines...
 September 6, 2016
Smartwatches with searchables

What Etailers Want and What Brands Want to Deliver

Etailers and brands have their own view on their products and they subsequently live in their own wo...
 August 10, 2016
trademagazine-taitra-taiwan

TradeMag Taiwan: The Netherlands New Cross-Border Port to Europe after Brexit

TradeMag in Taiwan interviewed Icecat CEO Hoogeveen and APAC director JJ Jan in its August 17, 2016 ...
 August 19, 2016
language-country-locale-code-table

Icecat Locales and Language Code Table

Within Icecat a large number of languages or locales (language and country combinations) are support...
 August 19, 2016
Fun's baby doll

Bol.com and Fun work with Icecat to improve online shopping toys

Content Supplier Icecat develops a standard for product information for toy brands. The standard for...
 September 6, 2016
Product video in Icecat

PIM for rich media assets and other data

There's a whole lot of confusion around the term PIM - Product Information Management system. A lot ...
 August 9, 2016
Putting things together

How a good PIM can unify your brand’s digital strategy

Spreadsheets, tons of spreadsheets for a new series launch. For marketeers their recurring nightmar...
 September 1, 2016
Bitcoin blockchain

What Should Etailers do with Blockchain, Bitcoin?

Bitcoin's hype in 2014, leading to its all-time-high of close to 1200 USD or 900 EUR, has marked t...
 September 19, 2016
checklist manufacturer xml

Checklist for Great Manufacturer Product Data

Brands like Philips, HP, 3M, Whirlpool and Tefal, start to understand the need for investing in the...
 September 14, 2016
Also holding ag

ALSO acquires Apple distributor Five4U

ALSO Holding AG (SIX:ALSN) announces that it is in exclusive talks to acquire Dutch Apple and suppli...
 September 2, 2016
website hamburger menu

Changes in the Icecat Website: introducing a Hamburger Menu

To make Icecat’s website more user friendly, a few changes have be...
 October 8, 2016
guide-through-difficult-terrain-color

Icecat API Manual Guidelines

This Icecat API Manual Guidelines is written to help to increase the usability and consistency of t...
 August 16, 2016

Icecat’s Global Mission: Product Content that Helps Buyers Decide

Icecat's global mission is to provide e-commerce partners with high-quality product information that...
 September 8, 2015

General Terms & Conditions Icecat

Version: January 24, 2014
 January 24, 2014
Japan shopping street

Online Shopping Market in Japan – Unique Shopping Mall or Global Interface

If you have never visited Japan, I’m pretty sure you will picture a lot of common stereotypes. For...
 October 31, 2016
FireShot Screen Capture #010 - 'Product data-sheet Cooler Master NotePal Erg_' - uk_icecat_biz_en_p_cooler-master_r9-nbs-e32k-gp_notebook-cooling-pad

Cooler Master offers free, rich product content

Cooler Master is now providing its Benelux and Nordics ...
 August 12, 2016
Update

Reviewing WordPress, Useful Tool for Creating Iceclog

We selected WordPress as we got positive references, and as it's the most popular open source
 August 31, 2016
Macy's webstore

Macy’s got it: kill overcapacity before it kills you

Macy's Inc. announces to close 100 of its US stores, 14% of its footprint, to start with locations ...
 August 12, 2016
Gigabyte_laptop

Gigabyte adds Where To Buy to its UK website

Gigabyte, the Taiwanese PC components and notebook brand, adds Where-To-Buy (WTB) to its UK websit...
 September 23, 2016
ecommerce

10 Dos and Don’ts for Starter Webshops

How to successfully manage your new webshop? From social content marketing to check out and shipping...
 October 12, 2016

Content License Icecat

Version: 1.25 June 15, 2017 THIS CONTENT LICENSE (“License”) is applicable to any content ser...
 June 30, 2015
FD Icecat naar beurs

Icecat’s IPO Announcement in the Fin Media in The Netherlands and Italy

Last week there was abundant response to Icecat's IPO announcement of November 3, 2016. Mainly in th...
 November 6, 2016
Redcoon webshop closed

Is Redcoon closing shop?

According to an unconfirmed internal email seen by 
 October 3, 2016
Icecat Top 10 Brands Q2 2016

Icecat Top 10 brands performing very well in Q2: Apple, Lenovo and Asus

The leading Icecat Top 1000 brands in Q2-2016 are respectively HP (+15%), Lenovo (+92%) and Philips ...
 August 2, 2016
top10_categories_Q2_2016_notebooks_pc_workstations

All-In-One PCs and Notebooks show explosive growth (Icecat Top 1000).

All-In-One-PCs and desktop-PCs continue to expand explosively in Q2-2016. Also leading category Note...
 August 3, 2016
EBA_Ruban_d'_Honneur_2016-17

Icecat Reaches the Finals at European Business Awards 2017

Icecat has been selected as finalist in the 2016/17
 February 7, 2017
NPEX SME Stock Exchange

E-commerce syndicator Icecat announces IPO at Dutch NPEX

THIS ANNOUNCEMENT DOES NOT CONSTITUTE AN OFFER TO BUY, OR THE SOLICITATION OF AN OFFER TO SELL, SECU...
 November 3, 2016
Iceimport by Iceshop

Connecting to 300 unique distributors through Iceimport

If you want to see stock and prices integrated in your webshop or ERP, Iceimport is a great service....
 October 18, 2016
Ecom Pro PIM solutions

Ecom Pro: managing product data

Ecom Pro is helping retailers in The Netherlands to enrich their product data from several sources, ...
 October 19, 2016
top10_fast_growth_categories_q2_2016_toys

Electronic toys booming

The Fast-Growth Categories in Icecat in Q2-2016, are led by electrical, toys, beauty categories and ...
 August 3, 2016
Icecat_NPEX_Gong

IPO of Icecat successful and trade commences at NPEX

THIS ANNOUNCEMENT DOES NOT CONSTITUTE AN OFFER, OR THE SOLLICITATION OF AN OFFER, TO BUY OR SELL SEC...
 March 2, 2017
Top 10 Brands 2016 e-channel

E-channel Top 10 in 2016: Acer doubles its Footprint. DIY and Toys Brands Soaring.

HP, Philips and Lenovo are leading the ecommerce channel in 2016, based on a measurement of 8.4 bill...
 January 31, 2017

Icecat is hiring: Front-end Developer

Published on: October 17, 2016 Location: Amsterdam Operating schedule: ...
 January 1, 2015
Top 10 Brands Icecat Q3-2016

Philips Number 1 Brand in e-channel in Q3 2016

In Q3, 2016, Philips overtook HP as the number one brand in the Icecat channel monitor. This is the ...
 October 20, 2016
Icecat top 10 Fast Growth Brands Q2 2016

Weidmüller and Studiocanal are fastest growing brands in Icecat Top 1000

The fastest developing E-channel brands in Q2-2016 are connectivity brands Weidmüller and Alcasa, w...
 August 2, 2016
Sales Manager Position

Icecat is hiring: Sales/New Biz Manager Netherlands

Location: Amsterdam/Nieuwegein Operating schedule: Full time Education:...
 September 17, 2016
takeaway-thuisbezorgd-ipo

Takeaway.com eyes 1 Bio EUR valuation in IPO at Amsterdam

Takeaway.com, the Amsterdam based meal delivery service, plans its IPO on September 30, at Euronext...
 September 20, 2016
escape room game

Dutch “Identity Games” chooses Icecat for product data

Identity Games, a Rotterdam toys company, offers standardized product information to its e-tailers v...
 October 27, 2016
Sales Manager Position

Icecat is hiring: Sales Manager Netherlands

Location: Icecat office Amsterdam Time: Full time Education: Completed Bachelor/University level e...
 September 17, 2016
Apple down the stairs

Apple versus Verstager: a Level Playing Field is Better

Verstager, the European Commission's (EC) competition chief, ruled that Apple has to pay it's reason...
 September 4, 2016
JumboDieset

JumboDiset uses Icecat for content syndication

JumboDiset, manufacturer of games, toys and puzzles, will offer its European Partners product inform...
 January 17, 2017

Open Content License

This document outlines the principles underlying the Open Content (OC) movement and may be redistri...
 October 2, 2015
marathon

E-commerce syndicator Icecat passes the minimum share subscription level at Dutch NPEX

After just 60 days since its IPO announcement, Icecat has reached the minimum subscription level of ...
 January 10, 2017

Icecat acquires e-commerce integrator Iceshop for 3.1 million euro

Icecat acquires e-commerce integrator Iceshop for 3.1 million euro Amsterdam, Th...
 December 28, 2016
Walmart lego brikz

Walmart Certifies Icecat as Content Provider

Walmart has approved Icecat as one of its Certified Content Service Providers for manufacturer produ...
 June 8, 2017
Sales Manager Position

Icecat is hiring: Region Manager D-A-CH (Icecat)

Location: Amsterdam Operating schedule: Full time Education: Master deg...
 August 17, 2016
RTL7 interview at Business Class

RTL TV interview of CEO Icecat about IPO

Today, was the broadcast in the RTL7 Business Class program of an interview of Martijn Hoogeveen by ...
 November 27, 2016

E-COMMERCE CONTENT EDITOR (Icecat)

Location: Manila, Philippines Operating schedule: Full time Education: ...
 August 17, 2016
a guide to reviews in ecommerce

A guide to using reviews in e-commerce

The positive impact of reviews in e-commerce is already a well-established concept in the industry a...
 November 1, 2016

Why choose to upgrade to Full Icecat?

We advise users to start their implementations with free Open Icecat. Next, if the technical interfa...
 February 17, 2017

Marketing & Sales Nordics Intern Wanted

Icecat is looking for an enthusiastic trainee, fluent in one of the Scandinavian languages, to expan...
 August 28, 2016
Top 19 categories 2016

Do It Yourself, Beauty, Toys & Lighting were Fastest Developing E-commerce Verticals in 2016

In 2016, the most popular online categories, according to Icecat, were notebooks, PCs and warranty &...
 February 4, 2017
Icecat_akeneo_connector

Akeneo announces the launch of its Icecat Connector

Open source Product Information Management (PIM) system provider
 February 14, 2017

Manual: downloading individual Product XMLs

This document describes how to download individual products from Icecat in 
 April 20, 2017
PIM backoffice for editors

Amazon’s Critical Image and Content Requirements

The minimum content requirements of Amazon and other major etailers are evolving, and are focused on...
 March 30, 2017
Sales Manager Position

Icecat is hiring: Country Manager UK

Location: Amsterdam/Nieuwegein Operating schedule: Full time Education:...
 September 23, 2016

International Standards Supported by Icecat

Without being complete, here follows a list of international standards supported by Icecat. ...
 February 17, 2017

Icecat image requirements based on retailer needs

The minimum image requirements of major e-tailers, such as
 April 25, 2017
E-commerce Platforms processing Product Data

Magento, PrestaShop and VirtueMart among most popular eshop platforms processing product data

Based on the Icecat sample of connected webshops in Q1 2017, the most popular standard webshop softw...
 April 18, 2017
Ledgable Blockchain Cloud

iMerge invests in blockchain cloud provider Ledgable

iMerge takes a share in Blockchain-As-A-Service (BaaS) provider
 June 29, 2017
Tech Data ceo Bob Dutkowsky

Tech Data closes $2.6 billion acquisition of Avnet Technology Solutions

Tech Data, the global tech distribution giant, closes its $2.6 billion acquisition of the Technology...
 March 3, 2017

Coverage Analysis of Your Catalog

All shops want good product information, for as many of their products as possible. Therefore, befo...
 January 25, 2017
Icecat user share by download method

XML, JSON and LIVE (JS) get more popular during Q1-2017

In Q1 2017, Icecat served 3.5 billion data-sheet, versus 1.7 billion registered in 2016. An annual i...
 April 19, 2017
GS1_SmartSearch
 May 16, 2017

Icecat Full Year 2016 Update

Amsterdam, The Netherlands, May 3, 2017: In 2016, Icecat’s revenues expanded by 10.3% to 6 million...
 May 3, 2017
Icecat PIM

Manage Your Product Content With the Free Icecat PIM

As a manufacturer, managing your product information can be a huge challenge: new pictures, expiring...
 June 20, 2017
Amazon Spain

Amazon Europe Chooses Icecat as Content Syndication Partner

In order to offer a better online customer experience, Amazon Europe takes up-to-date product data f...
 July 5, 2017
Picnic delivery

Picnic Raises 100 Million Euro to Expand its Online Food Delivery in Holland

Online grocery retailer Picnic, raises 100 million euro from NPM Capital, Fentener van Vlissingen an...
 March 28, 2017

Media Markt’s content requirements

In order to further boost customers' online experience, Media Markt is considerably improving its pr...
 May 17, 2017

Snap raised $2.3 billion at gigantic valuation of $34 billion after one day of trade

Snap Inc's IPO valuation at $22 billion invokes speculation and debate. After a day of trading the v...
 March 4, 2017

Manual: Icecat Product XMLs batch processing

This document describes how to download a batch of products from Icecat in 
 June 6, 2017

Fashion, Toys and Lighting Categories Surge in Q1 2017

In Q1 2017, the fastest growing categories are in Fashion (Women's Shorts & Tops), Toys (Aircraf...
 May 10, 2017

Westcoast’s Product Content Requirements for Brands

"Westcoast is constantly striving to work more efficiently with its suppliers and invites them to ta...
 June 8, 2017
Brands Connected eplatforms Q1 2017

Philips most popular in Q1 2017, HP most connected

Philips took over the pole position in the Icecat Top 10 Brands of Q1-2017, based on nearly 4 billio...
 May 9, 2017
Icecast

Manual for Icecast – Individual Product Download to Your Desktop

Open Icecat is a free service that enables you to insert (real-time) product content from some 300 m...
 July 10, 2017
grocery_shopping

Amazon Buys Whole Foods Market For $13.7 billion

Amazon announced to buy the high-end organic grocery 
 June 16, 2017
MtGox, where are my bitcoins

Where are my bitcoins, Mark Karpeles?

Today, Mark Karpeles, the CEO of the bankrupted MtGox bitcoin exchange, pleaded "not guilty" in the ...
 July 11, 2017
Icecat live

Icecat LIVE- Manual For Granular Call

Icecat LIVE is a (free) service that enables you to insert real-time product content from some 300 m...
 June 8, 2017
Importing_ProductContent_Into_Your_Webshop

Manual: How to Import Free Product Content Into Your Webshop via Icecat

This quick guide will show you how to easily import relevant product information from Icecat into yo...
 August 8, 2017

Toy Industry up-to-play with Content Standard (Register for the Event on Sept 7, Utrecht)

To inform the toy industry, brands and channel partners, about the new global data standard for Toys...
 August 16, 2017