A reference set is a named collection of up to 10 documents that describe how your content should be written: a client's style guide, product manuals, brand rules, voice samples. wxrks reads the documents, writes a summary of their rules, and lets you search them by meaning. From that summary, you can create a Sous-Chef profile, the set of instructions the AI follows when it translates.
Who can do this:
Account Admin: has the View Reference Sets and Manage Reference Sets permissions by default, and is the only role that can create a Sous-Chef profile from a summary.
Other users: need View Reference Sets to open reference sets and Manage Reference Sets to create and change them. An Account Admin grants them in People > Users > [User] > Permissions. A user whose permission covers only some Organizational Units can manage only the sets that apply to those units.
ℹ️ Note: A reference set doesn't change translations by itself. Its rules reach translation through the Sous-Chef profile you create from its summary (section 5).
Key concepts
Term | Meaning |
Reference set | A named collection of up to 10 reference documents, listed in Context > Reference sets. |
Summary | A Markdown brief that wxrks writes from the set's documents: the rules, terms and tone they describe. You can edit it. |
Summary focus | An optional instruction that steers what the summary looks for, for example the tone of voice samples. |
Default | The reference set every account has. It applies to every Organizational Unit that has no reference set of its own. It can't be deleted. |
Applies to | The Organizational Units a reference set is bound to. A bound Organizational Unit uses its bound reference sets instead of the default. |
1. Create a reference set
In the sidebar, go to Context > Reference sets. The page lists every reference set with the Organizational Units it applies to, its document count (for example 6/10) and the status of its summary.
Click New reference set.
Enter a Name your team will recognize, such as the client or product the documents cover.
Optionally, enter a Description of what the documents cover.
Optionally, choose the Organizational Units the reference set applies to. You can bind them later from the set's page (section 4).
Click Create. The reference set's page opens, ready for documents.
2. Upload documents
On the reference set's page, drop files on the Documents area, or click it to browse. Each reference set holds up to 10 documents.
Limit | Value |
File types | PDF, Word, PowerPoint, HTML, XML, JSON, YAML, text, Markdown or CSV ( |
File size | Up to 50 MB per file |
Documents per reference set | 10 |
A file outside these limits isn't uploaded: a message names the file and the reason, for example The file exceeds 50 MB.
After uploading, each document moves through these statuses:
Status | Meaning |
Uploading | The file is being sent. |
Queued | The file is waiting to be read. |
Processing | wxrks is extracting the text and making it searchable. |
Ready | The document can be searched and is included in the summary. |
Error | The document couldn't be read. The reason shows under its name. |
ℹ️ Note: A reference set keeps each file once. A file identical to a document already in the set ends in Error with The same file is already in this reference set: delete it.
From a document's row, click Download to get the original file, or Delete document to remove it.
3. Review and adjust the summary
A couple of minutes after the last document change, wxrks reads the Ready documents and writes the Summary: the rules, names, terms and tone they describe. Its status reads Generating while it is written, and Ready when it is done. When documents change afterwards, the summary turns Stale and is written again.
The three icons next to the status are Edit summary (pencil), Regenerate summary (circular arrows) and Create Sous-Chef profile (chef hat).
To correct the summary by hand, click Edit summary, change the text in the Summary box (Markdown is supported), and click Save.
⚠️ Warning: An edited summary is not regenerated automatically. When documents change later, the summary shows Documents changed since this summary was edited. Clicking Regenerate summary replaces your edits with a new summary written from the documents.
To steer what the summary looks for, for example when the documents are voice samples rather than rules:
Click Edit summary.
In Summary focus, describe what the summary should look for, for example Treat the texts as voice samples and describe their tone, rhythm and word choice.
Click Save focus and confirm. wxrks reads the documents again with that focus and regenerates the summary. If you had edited the summary, the new one replaces your edits.
4. Choose the Organizational Units it applies to
Binding a reference set to Organizational Units records which clients or teams its documents belong to. It also decides who can reach it: a user whose permissions cover only some Organizational Units sees the sets bound to those units.
In the Applies to panel, choose the Organizational Units in the list and click Save.
An Organizational Unit with at least one reference set bound to it uses those sets instead of the Default set. An Organizational Unit with no reference set bound uses the Default. To keep the default for an Organizational Unit that also has its own sets, bind the Default set to that unit too.
To check which reference sets an Organizational Unit uses, go to Organizations > Organizational Units, open the unit and click Context. The Reference sets applied here card lists them. It shows Default (no override) when the unit has no set of its own.
ℹ️ Note: A reference set that is neither the Default nor bound to an Organizational Unit applies nowhere. You can still open it, search it and create a Sous-Chef profile from it.
5. Create a Sous-Chef profile from the summary
When the summary is Ready, an Account Admin sees Create Sous-Chef profile in the Summary panel.
Click Create Sous-Chef profile (chef hat icon). wxrks drafts a profile from the summary and opens the Add profile dialog with its fields filled in: Name, Description, Domain, Formality, Tone, Audience and Instructions. The instructions hold the summary itself, or a condensed version that keeps its rules and terms when it is too long for a profile.
Review every field, especially Formality and Tone. wxrks fills them only when the summary matches one of their options; otherwise they show Pick one and you must choose.
Click Create profile. Nothing is saved before this step.
A confirmation reads Sous-Chef profile “[name]” created. The new profile joins the account's Sous-Chef profiles, marked Reference set. It isn't the default anywhere, so it doesn't affect any translation yet. To put it to use, click Open Sous-Chef profiles in the confirmation, or go to Settings > AI > Sous-Chef profiles, and assign it to the account, Organizational Units or language pairs as described in How to set up Sous-Chef profiles.
In Sous-Chef profiles, the profile's details read Created from the reference set followed by the set's name.
💡 Tip: The profile is a copy. Later changes to the reference set's documents or summary don't update it. After a major change to the documents, create a new profile from the new summary.
6. Search the documents
Use Search on the reference set's page to find what the documents say about a topic, for example how to write dates. Type a question or a few words and click Search. The search goes by meaning, not exact words: each result shows the matching passage, the document it comes from and, as a percentage, how close it is to your query.
Search becomes available once at least one document is Ready.
7. Edit or delete a reference set
To rename a reference set or change its description, click Edit at the top of its page.
To delete it, open More actions (⋯) at the top of its page, or in its row of the list, and click Delete reference set.
⚠️ Warning: Deleting a reference set deletes all of its documents and can't be undone. Sous-Chef profiles created from it are kept. The Default reference set can't be deleted.
Troubleshooting
Problem | What to do |
Reference sets doesn't appear under Context | You need the View Reference Sets permission. Ask an Account Admin. |
New reference set, Edit or the Applies to list is missing or disabled | You need the Manage Reference Sets permission. If your permission covers only some Organizational Units, you can change only sets bound exclusively to your units, not the Default or unbound sets. |
A file is refused with This file type is not supported or The file exceeds 50 MB | Convert it to one of the supported types, or split it into smaller files. |
A document is in Error | Read the reason under its name. No text could be extracted from the file usually means a scanned PDF with no text layer: upload a version with selectable text. A file holding more than 2,000,000 characters of text is refused too: split it. For any other reason, click Retry. |
The summary reads Summary will be generated once documents are processed | No document is Ready yet. Wait for processing to finish. |
Create Sous-Chef profile doesn't appear | Only an Account Admin sees it, and only when the summary is Ready and you aren't editing it. |
Related articles







