Source material

Their sentence, your citation, your customer

Most catalogues are built out of text nobody in the business wrote. It arrives in a feed, in a datasheet, in a folder from a rep, and it goes onto the product page because writing four hundred descriptions is not a realistic afternoon. That is a perfectly normal way to run a shop. It becomes something else when an assistant retrieves one of those paragraphs, cites it, and hands it to a customer inside your own widget, at which point somebody else's marketing has become your statement about a product you sold them.

Why this one is harder than it looks

It was written to sell into a channel, so its register is not yours. Performance figures measured under conditions the paragraph does not name. Durability claims with no qualifier. Broad assertions of compatibility that mean compatible with a family rather than with the thing your customer owns. On a product page, surrounded by your prices and your photographs, a reader discounts this the way they discount all packaging copy. Quoted back as a cited answer to a direct question, it reads as verified, because a citation is a claim that somebody checked.

It describes a product family, not your line. Supplier text travels with the thing rather than with your arrangement, so it can list an accessory that is not in the box you ship, describe a bundle sold in another market, name a helpline that is theirs, or set out a warranty they administer and a return route that is not yours. The question about what is included then gets answered from somebody else's packing list, which is the single most common way this goes wrong.

It is frozen at the moment you pasted it and it changes on their side. Manufacturers soften claims, revise specifications between production runs and update their own documents without telling their resellers. Your copy holds the version that was current when the feed was imported, and there is nothing in the text that dates it or points at the original.

And some of it is not description at all. Installation steps, safety warnings, dosage or usage limits, care instructions, load ratings. Those are the passages where a wrong or partial answer is not an embarrassment, and they are the ones most damaged by ordinary editing, because a warning that has been trimmed to fit a product page has usually lost the condition that made it a warning.

What it has to contain

Structure rather than wording. A passage pulled out of this document has to stand on its own, because that is the only form in which it will ever be read.

Structural requirements
Attributes indexed, claims quarantinedDimensions, weights, materials, capacities, part numbers, standards conformance and what fits what. These are checkable, they are what people ask, and they carry no promise beyond themselves. Superlatives, performance assertions and lifetime language do not go in as statements.
Attribution written inside the block, not left to the citationA sentence in the passage saying the description that follows is the manufacturer's own. A citation points at your document, and your document is the thing that will be read as speaking, so the attribution has to be in the words.
Everything commercial written by you, in the same documentWhat is in the box you ship, what you charge, who handles a warranty claim, how it is returned, how long delivery takes. Yours, in your words, sitting beside the borrowed description so that a question about what somebody gets matches your paragraph rather than theirs.
Instructions taken whole or not taken at allSafety, installation, care and usage text is indexed complete, with its conditions, or replaced by a line saying to follow the instructions supplied with the product and where a copy can be obtained. There is no useful middle position.

The rewrite, in order

Sort the borrowed text into attributes, claims and instructions

Take one supplier description and mark it up in three colours. Attributes are the facts a customer could verify with a tape measure or a label. Claims are the sentences asserting how well it performs, how long it lasts, or how it compares. Instructions are anything telling somebody how to fit, use, maintain or handle it safely.

Each pile has a different rule, which is the entire point of the exercise. Attributes go in as they are, because they answer the questions people ask and they are true or false in a way anybody can settle. Claims get rewritten or attributed. Instructions get taken whole or left out.

Doing this once on a representative product tells you what the feed is mostly made of, and for most catalogues the answer is a surprise: the useful attributes are a short list, and the bulk of the paragraph is claim.

Turn a claim into an attribute, or say whose claim it is

Most claims have a factual core that can be lifted out. A sentence about exceptional battery performance usually sits on a stated capacity or a tested runtime under some condition. Publish the figure and the condition, drop the adjective, and you have a passage that answers the same question and cannot be read as a promise you have no way to stand behind.

Where there is no factual core, the choice is to attribute it in the text or to leave it out. Attribution means a sentence naming the manufacturer as the source of the description that follows, inside the same block, so that any passage carrying the claim also carries whose claim it is.

Compatibility deserves its own decision, because it is the most asked and the most confidently overstated. A supplier saying a part suits a range is describing a family. Your customer is asking about one specific thing they own. Publish the list of what you have actually confirmed and say plainly that anything outside it is unconfirmed rather than letting a broad phrase do the work.

Put your own commercial facts in the same block

The questions that follow a product question are almost always yours rather than the manufacturer's. What comes in the box. What it costs. What happens if it fails. Who to contact. How it comes back. If those answers are not in the same document as the description, the description is what gets retrieved for them, and the description was written by somebody with a different box, a different warranty and a different phone number.

Write a short block per product, or per range where the answers are identical, and put it directly beneath the borrowed text. It does not need to be elegant. It needs to contain the words included, in the box, warranty, return and contact, because those are the words that will be typed.

Say explicitly where a warranty is administered by the manufacturer rather than by you, and give the route. That single sentence prevents the most reliably expensive misunderstanding in resale, which is a customer who believes they have a claim against the wrong party and has a cited answer saying so.

Decide who rechecks it, and how often

Borrowed text has no owner by default, which is how a specification stays on a page three revisions after the product changed. Assign the recheck to whoever manages the supplier relationship, on whatever interval matches how often that supplier revises things, and write the date of the last check into the document.

When a feed is reimported, treat it as a new document rather than an update to an old one, and remove the previous version. Two generations of a description differ in their text, so both persist, and both can be retrieved for the same question with nothing to indicate which reflects what you are currently shipping.

This is also the moment to ask whether the whole datasheet belongs in the index or only the part you sell. A manufacturer's document usually covers a range, and the passages describing the variants you do not stock are pure competition for every question about the one you do.

What happens if you skip it

A manufacturer's promise, delivered with your citation on it

Somebody asks how long the thing lasts, or how much it holds, or whether it will handle a particular job. The strongest passage is the supplier paragraph, because it is the only text you own that addresses performance at all, and it says what marketing copy says. The answer arrives confident and cited. Your business has now made a performance claim it did not write, cannot substantiate and did not know it had published.

The everyday version is duller and more frequent. A customer asks what is included, and the answer lists an accessory from the manufacturer's description of a bundle sold somewhere else. The package arrives without it. Nobody involved has done anything unreasonable: the copy was accurate about a product, just not about the one in your warehouse.

The version that matters most is the trimmed instruction. A safety or installation line that was shortened to fit a product layout, retrieved and quoted as guidance, with the condition that made it safe advice edited out somewhere upstream. This is the one case in this file where the cost of a partial answer is not commercial.

Check it against this

Before you index it

  • Every borrowed block names the manufacturer as its source inside the text
  • Performance claims were replaced by figures and their measurement conditions
  • Compatibility is a list of what you have confirmed, not a family description
  • What is in the box, the price, the warranty route and the return route are written by you
  • Safety and installation text is complete with its conditions, or absent
  • The last check date is recorded and only one generation of the copy is indexed

Questions

Can we index the manufacturer's datasheet directly?
You can, and it arrives with their scope, their contact details and their warranty terms attached. It works best for genuinely technical questions where the attributes are the answer. Pair it with a short block of your own covering what you supply, or the datasheet will be what answers every commercial question too.
Are we allowed to republish supplier copy at all?
That is a question for your supply agreement rather than for us. Many feeds are provided for exactly this purpose and some are not, and the answer differs by supplier. Worth settling before a few hundred descriptions are indexed rather than after.
What about third party reviews and independent test results?
The same rule, applied harder. Attribute inside the text, quote narrowly rather than summarising, and never index a figure you could not point at a source for. A test result quoted without its conditions behaves exactly like a manufacturer claim, and it has the additional problem of sounding neutral.

Keep reading

Try it on your own material

Upload a document or point it at your site, paste one line of HTML, then ask it something only your business could answer.