Reference letters. Clear. Fair. Compliant.
Secret codes · Knowledge9 min readLanguage & codes
Knowledge · Codes

Secret codes in the Swiss work reference

What codes are, why they are problematic — and how the same message can be put as plain text, without legal risk and without personal harm.

  • Complete grading-level list
  • Plain-text alternatives per code
  • Why codes are legally risky
Definition

What are secret codes?

Secret codes (also: reference codes, encryptions) are formulations in work references that convey a different — usually more negative — message to insiders than to non-insiders. Classic example: "always to our complete satisfaction" is read in the code tradition as grade 1, "to our satisfaction" without an adverb as grade 4.

In Switzerland, codes are widespread but not regulated by law. They have established themselves in practice over decades — and today face increasing criticism, both legally and socially.

Performance assessment

The classic grading-level list

This is how the classic code tradition reads the typical satisfaction phrases. The plain text next to it shows how Kompass would say the same thing — without code.

"… always to our complete satisfaction …"
Grade 1 (very good)
Ms X fully achieved her annual goals and exceeded them in [specific area] by Y per cent.
"… always to our full satisfaction …"
Grade 2 (good)
Mr Y reliably met the requirements of his role; in [specific area] he showed above-average results.
"… to our full satisfaction …"
Grade 3 (satisfactory)
Ms Z met the requirements of her role. In [specific area] she achieved [specific result].
"… to our satisfaction …"
Grade 4 (sufficient)
Mr A met the essential requirements of his role. In [area] there was development need, which was worked on in regular employee meetings.
"… endeavoured to complete the assigned tasks …"
Grade 5 (poor)
In [specific task areas], the requirements were not consistently met; corresponding feedback was documented in employee meetings on [dates].
"… was always striving to meet the requirements …"
below grade 5
— This formulation should not be used at all. If performance was permanently insufficient, that belongs in documented employee meetings and possibly a separation — not in an ambiguous reference formulation.
Conduct

Codes in the conduct section

Coding is particularly common here — for example by omitting a group of people or through positive-sounding stock phrases with a hidden core of suspicion.

"… exemplary conduct toward superiors, colleagues and customers …"
Top conduct
Within the team, Ms X acted collegially and in a solution-oriented manner. Conflicts were addressed early and resolved constructively.
"… impeccable conduct toward superiors and colleagues …"
Notable: customers are missing
— Omitting a group (here: customers) is taken in classical code reading as a hint of difficulties in that relationship. Instead of coding: describe concretely or omit explicitly.
"… contributed to improving the working atmosphere …"
Code: alcohol issue
— This phrasing is read in the code tradition as a hint of suspicion. It is legally risky and harmful. If there was a concrete incident, it belongs in documented conversations, not in the reference.
"… showed understanding for his work …"
Code: no performance
— Avoid. If the person did not fulfil the tasks, that belongs honestly and substantiably in the performance assessment — not in a stock phrase with double meaning.
Four reasons

Why are codes problematic?

Duty of clarity violated

A formulation that industry insiders understand differently from the person concerned is legally problematic. The reference must be understandable for third parties.

Correction claim becomes more likely

Whoever uses codes must, before a court, plausibly explain what the codes mean and whether they correspond to the truth. This regularly leads to correction claims.

Reading errors cost careers

Codes are read inconsistently. What one HR person reads as "grade 3", the next interprets as "grade 2". This disadvantages applicants without necessity.

No real information

Codes encrypt precisely the information that would help recipients — namely concrete observations. Plain text says more and is more robust.

How to do it better

Four plain-text alternatives

The same messages — factual, substantiable and traceable. That is the Kompass approach.

Observable behaviour

Instead of "was always striving" → "On project X Mr Y met the requirements. In area Z, development steps were agreed in employee meetings."

Concrete examples

Instead of "complete satisfaction" → "She reliably achieved the quarterly goals and exceeded them in Q3 by 12 per cent."

Weighting instead of omission

If an aspect was weak: do not leave it out (that is read as a code) but describe it more briefly and factually. Nobody expects a perfect profile.

Silence where there is nothing to say

What was not observed does not belong in the reference. A conduct assessment "toward customers" is omitted if the role had no customer contact — without that being negative.

CO + practice

What the legal situation says

The Swiss Federal Supreme Court has reaffirmed the duty of clarity in several decisions: a formulation that is meant differently for an industry-savvy third party than for the person concerned can ground a correction claim — even if it would be accurate according to classical code understanding.

In practice this means: whoever uses codes today bears the risk of having to explain and substantiate the meaning in a dispute. Whoever uses plain text bears the (smaller) risk of having to specify in individual cases — which usually succeeds easily with good meeting notes.

More on this on the page CO art. 330a and in our explanation of the tension goodwill vs. truth.

FAQ

Frequently asked questions about secret codes

What are secret codes in a work reference?
Hidden or ambiguous formulations with which employers encrypt assessments without stating them openly. Classic examples: "always to our complete satisfaction" as encrypted grade 1, "was always striving" as encrypted grade 5. In Swiss practice such codes are widespread, but legally increasingly attackable.
Are secret codes allowed in Switzerland?
Not expressly forbidden — but they violate the duty of clarity that follows from Art. 330a CO and scholarship. A formulation that is meant differently for an industry-savvy third party than for the person concerned is legally risky. In doubt, the person, not the employer, wins in a correction dispute.
Which codes are particularly common in Swiss work references?
The grade levels via the "satisfaction adverb": "always complete" = 1, "always full" = 2, "full" = 3, "satisfaction" without further qualifier = 4, "endeavoured" = 5. In conduct, omitting a group (e.g. customers) is read as a hint of difficulties. Positive stock phrases such as "contributed to improving the working atmosphere" also have a code tradition as a suspicion phrase.
Why does ZeugnisPilot deliberately avoid codes?
Because they run counter to the core task of a work reference: giving a third party a factual assessment of the work. Codes encrypt precisely the information recipients need. The Kompass Standard instead uses observable behaviour and concrete examples — fairer for both sides and legally more robust.
What if I suspect codes in a reference I received?
You have a correction claim. Object in writing to specific passages, with reasoning, what you read as problematic and what formulation you would consider appropriate. The employer must then justify their assessment plausibly.
Can I as an employer still use codes today?
You can — but the risks are rising. Correction claims are becoming more frequent, courts interpret the duty of clarity more strictly, and newer HR generations reject codes. Whoever starts fresh today is legally and procedurally better off with plain text per Kompass Standard.
How do I automatically check whether codes are in the draft?
ZeugnisPilot's compliance check examines every draft against typical code patterns and flags findings with reasoning. You decide per finding: accept, reject or override — the audit trail documents your choice.

No code, no code risk

ZeugnisPilot's compliance check examines every draft against the typical Swiss code patterns and proposes plain-text alternatives — per finding with reasoning.