Org Knowledge lets you add company documents, such as your employee handbook, leave policy, or expense policy, to Deel. Deel AI uses these documents to answer your team's questions about how your company works, and each answer shows its source. This article explains how to upload a document, choose who it is for, and manage your documents.
You must be:
- A client admin with permission to manage your organization, to upload or delete documents
- In an organization where Deel AI is turned on
- Uploading a PDF, Word (.docx), or text (.txt) file of 25 MB or smaller
In this Article
How to add a document to Org Knowledge
How Deel AI uses your documents
How to add a document to Org Knowledge
Step 1 – Open Org Knowledge
- In the left menu, go to Knowledge.
- Select Org Knowledge, next to Knowledge Hub.
Step 2 – Upload your file
- Select Upload files.
- Drag your file into the box, or select Click here or drag file to upload.
- Select + Add more to upload more than one file.
Step 3 – Add the details
- Select a Category that fits the topic best. Options are Hire and onboard, Grow and perform, Change and update, Time and pay, Off-board and exit, Company-wide, Webhooks and integrations, and Analytics.
- Enter a Document description (optional), up to 500 characters.
- Choose Permissions for who the file is for. See the table below.
| Permission | Who Deel AI uses it for | Who sees it in Org Knowledge |
|---|---|---|
| Anyone in [your company] (Including workers) | Everyone in your company, including your workers | Everyone in your company |
| Org admins | People on your company's side of Deel (client users) | People on your company's side of Deel |
Note: "Org admins" files are shared with everyone on your company's side of Deel, not only admins. Workers never see them, in the list or in answers. Don't add anything there that your wider client team shouldn't see.
Step 4 – Save and wait for it to sync
- Select Save. You will see "Upload completed".
- Check the file status. It shows Pending while Deel prepares it.
- Wait until the file shows Synced. Deel AI can then use it.
Note: If a file shows Failed, delete it and upload it again. See Troubleshooting below.
Step 5 – Test the document
- Open the ⋮ menu for a synced file and select Try in chat.
- Check the sample answer. Deel AI opens with a sample question about your document.
Tip: Org Knowledge is for company-wide policies and guides. Don't upload files that contain personal or health information about individual people.
Limitations
| Item | Limit |
|---|---|
| File types | PDF, Word (.docx), text (.txt) |
| File size | Up to 25 MB per file |
| Number of files | Up to 100 per company |
| Description | Up to 500 characters |
| Permissions | Anyone in your company, or Org admins. You can't set them by country, team, or department yet. |
What you can add
You can add any company-wide policy or guide. Your employee handbook is the most common example. Others include:
- Time off and pay: leave, sick days, parental leave top-ups, holiday calendars, overtime, bonus or commission rules
- Expenses and travel: what people can claim, limits, and how to submit
- Ways of working: remote work, working hours, office rules, code of conduct
- Onboarding: first-week guides, who to contact, equipment and IT setup
- Growing: performance reviews, promotions, training
- Leaving: resignation steps, notice periods, returning equipment
- Benefits: what's included in each country and how to enroll
Don't add documents about one person, such as contracts, payslips, or medical notes. Those stay in each person's documents in Deel.
How Deel AI uses your documents
- Answers come from your policy and the law. When someone asks a question your document covers, Deel AI answers from it and shows the document it used.
- Local law still applies. If your policy differs from local law, Deel AI gives your company's rule and names the legal minimum next to it. It never says your policy overrides the law.
- This isn't a compliance check. Deel AI doesn't review or approve your policies. Keep checking your policies against local law as you do today, especially for Employer of Record (EOR) countries.
- It's only for Deel AI. Deel's support team doesn't see your files when they handle your requests.
How your data is handled
- Your documents stay in your organization's account. They are used only to find answers, and never to train AI models.
- Deel's AI providers work under zero data retention agreements, so they don't store your data or train on it.
- When you delete a file, Deel AI stops using it straight away. Backups that already contain it are kept for up to 90 days.
- Deel is independently certified for SOC 2 Type II, ISO 27001, ISO 27701, and ISO 42001. Learn more in the Deel Trust Center.
How to manage your documents
Caution: Deleting a file stops Deel AI from using it straight away.
Step 1 – Open the ⋮ menu next to a file
- View file: open the file. PDFs open inside Deel.
- Edit details: change the file's details.
- Delete: remove the file. Confirm in the pop-up.
Step 2 – Search and filter your files
- Use the search box at the top of the list.
- Use the filters Category, Document type, Permissions, Added by, and Status to narrow the list.
Frequently Asked Questions
Which worker types does Org Knowledge work for?
It works for everyone in your company who uses Deel AI: client users, EOR employees, Global Payroll employees, direct employees, PEO employees, and contractors, including Contractor of Record (COR).
Please note : Workers get answers only from files set to "Anyone in [your company]".
Can I show a file only to one country or worker type?
Not yet. A file set to "Anyone in [your company]" is open to all your workers, in every country and of every worker type. Deel AI does know who is asking, including their country and worker type, and uses this to pick the most relevant file. For example, a direct employee in France who asks about annual leave gets the answer from your France handbook.
To help Deel AI pick the right file:
- Upload one file per country and worker type.
- Use clear file names, such as "France Employee Handbook 2026 (direct employees)".
- Say who the file is for on its first page, such as "This policy applies to employees in France employed directly by [your company]".
- Set anything workers shouldn't see to "Org admins".
How does it work for Employer of Record (EOR) employees?
For EOR employees, Deel is the legal employer. When an EOR employee asks a question, Deel AI uses your policy together with Deel's EOR terms for their country. Your policy adds to those terms, but it doesn't replace them.
How do I update a policy?
Does it cost extra?
No. Org Knowledge is included in your Deel plan.
Can I upload a different handbook for each country?
Yes. Upload each one as its own file. Use clear file names, such as "UK Employee Handbook 2026", so answers stay tied to the right country.
How do I update a policy?
Delete the old file, then upload the new version. This way Deel AI only uses your latest policy.
I don't have a handbook yet. Can Deel help?
Yes. Deel's HR services team can build one for you. Contact your Deel account manager to learn more.