# Writing for Mirakl

## What is UX Writing exactly? <a href="#id-1536cb" id="id-1536cb"></a>

UX writing is about finding the right content and words to design interfaces that will help operators and sellers achieve more.

UX writing is different from copywriting and SEO writing (on the marketing side) as it's not meant to sell or promote anything but to help and guide users throughout a product.

UX writing is also a way of thinking. It's about using research and data to give our users the information they need at the right time and in the right format. Regarding UX writing, the less you see the words, the better.

Thus, every part of the Mirakl platform, even the smallest item, is an opportunity to increase user activity, engagement, retention, and brand preference.<br>

## The 5 pillars of UX Writing <a href="#id-66bfef" id="id-66bfef"></a>

By order of importance:

* **User-driven:** what you write must reflect the user’s needs and feelings (achieved through research, real-life conversations, and interviews)
* **Clear:** what you write must be easy to understand (simple words, little jargon)
* **Concise:** what you write must be easy to scan (short sentences, carefully-picked words)
* **Useful:** what you write must guide or move the user forward (action verbs, guidance)
* **On-brand:** what you write must reflect the brand tone of voice (vocabulary, tone variations)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://design.mirakl.com/content/writing-for-mirakl.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
