{"site":{"name":"Koji","description":"AI-native customer research platform that helps teams conduct, analyze, and synthesize customer interviews at scale.","url":"https://www.koji.so","contentTypes":["blog","documentation"],"lastUpdated":"2026-11-16T00:28:44.077Z"},"content":[{"type":"documentation","id":"5e450aaa-5caa-4b72-a18b-0e9cac51cbd4","slug":"uploading-context-documents","title":"Uploading Context Documents","url":"https://www.koji.so/docs/uploading-context-documents","summary":"Context documents give Koji's research assistant background knowledge about your product, domain and earlier research while it designs your study. This guide covers supported formats (PDF, TXT, JSON, MD, up to 25 MB, five per study), what to upload, how files shape the brief and questions, and why the AI interviewer works only from the published study.","content":"Context documents give Koji's research assistant a richer understanding of your research landscape. They're background materials that help it design a more informed study: a sharper brief, better questions and a clearer target participant. Think of them as briefing materials you'd hand to a human research assistant before they start drafting your discussion guide. They stay with you and the research assistant. The AI interviewer never reads them during a participant's interview; it works from the study you publish.\n\n## Why Context Documents Matter\n\nWithout context documents, Koji works with what you tell it in the chat conversation. That's often enough for straightforward studies. But when your research lives within a specific domain — a particular product, a niche market, a complex organizational structure — extra context can make a meaningful difference to how the study is designed.\n\nHere's what context documents help with:\n\n### Better Question Design\n\nWhen the research assistant has access to your product documentation, previous research, or market analysis, it can craft interview questions that reference real features, actual pain points, and genuine use cases rather than generic placeholders. This applies to both open-ended questions and [structured question types](/docs/structured-questions-guide) — context helps it suggest more relevant scale endpoints, choice options, and ranking items.\n\n**Without context:** \"How do you use the product in your daily work?\"\n**With product documentation as context:** \"How does the workflow automation feature fit into your team's daily operations?\"\n\n### A Sharper Brief\n\nThe research assistant uses your files when it drafts the problem statement, the hypothesis, the decision the study should inform and the topics to cover. Those parts of the [research brief](/docs/understanding-the-research-brief) are what the AI interviewer works from, so a well-informed brief is how your context reaches every interview.\n\n### Accurate Terminology\n\nEvery domain has its own vocabulary. Context documents help the research assistant use the right terms in the questions and the brief — your product's feature names, your industry's jargon, your organization's terminology. Because the interviewer asks the questions as written in the study, the right words carry through to the conversation.\n\n### Better Structured Question Design\n\nWhen the research assistant has access to your existing data — previous NPS scores, known feature lists, competitive landscape — it can design more targeted [structured questions](/docs/structured-questions-guide). For example, context about your product's feature set helps it suggest accurate options for multiple-choice or ranking questions, rather than generic placeholders.\n\n## Supported File Formats\n\nKoji accepts the following file types as context documents:\n\n| Format | Extension | Best For |\n|---|---|---|\n| PDF | .pdf | Research reports, whitepapers, product specs |\n| Plain Text | .txt | Quick notes, raw content, transcripts |\n| JSON | .json | Structured data, API documentation, survey results |\n| Markdown | .md | Technical documentation, README files, knowledge bases |\n\nEach file can be up to 25 MB. Word documents aren't accepted directly: save them as PDF first.\n\nYou can upload up to **5 files** per study. This limit keeps the research assistant focused — too many documents can dilute the signal. Choose the most relevant materials rather than uploading everything you have.\n\n## What to Upload\n\nNot all documents are equally useful. Here are the types that tend to have the biggest impact:\n\n### High-Value Context Documents\n\n- **Previous research findings** — summaries or reports from past studies on related topics. These help the research assistant build on what you already know rather than retreading old ground.\n- **Product documentation** — feature descriptions, user guides, or product specs. These help it understand what participants are using and what language to use when asking about it.\n- **Customer feedback summaries** — compiled feedback from support tickets, NPS surveys, or review platforms. These surface recurring themes worth turning into questions or topics.\n- **Competitive analysis** — information about alternatives in your market. This helps it understand the landscape participants are navigating.\n- **Internal strategy documents** — product roadmaps, quarterly plans, or team goals. These help align interview questions with strategic priorities, without exposing the documents to participants.\n\n### Less Useful Documents\n\n- **Raw data dumps** — large spreadsheets or databases without context. The research assistant can't easily extract relevant information from unstructured raw data.\n- **Entire codebases** — technical implementation details rarely help with qualitative research design.\n- **Legal or compliance documents** — unless your study is specifically about legal compliance, these add noise without signal.\n- **Marketing materials** — these tend to describe ideal states rather than reality, which can bias the questions toward your own story.\n\n## How to Upload\n\nAdding context documents to your study is straightforward:\n\n1. Open your study in the design workspace\n2. Click **Attach** next to the chat with the research assistant, or drag and drop your files onto it\n3. Your files are processed and read by the research assistant\n4. Open the files list at any time to view or delete a file\n\nYou can upload documents at any point during the design process — before you start chatting with the research assistant, during the conversation, or after the [research brief](/docs/understanding-the-research-brief) is drafted.\n\n**Tip:** Uploading documents before your first message tends to produce the best results, since the research assistant can factor in the context from the very beginning.\n\n## How Context Documents Are Used\n\nContext documents are design material. They shape the study, and the study shapes the interview.\n\n### During Study Design\n\nThe research assistant draws on your context documents when suggesting methodologies, drafting interview questions, defining your target participant, and recommending [structured question types](/docs/structured-questions-guide). You'll notice more specific, grounded suggestions compared to studies without context.\n\n### During Interviews\n\nThe AI interviewer doesn't read your context documents. It works only from the study itself: the problem, the hypothesis, the questions, the topics and the guardrails you can see and edit. That's deliberate. Roadmaps, hypotheses and earlier participants' data are the researcher's material, and an interviewer that has read them is more likely to ask leading questions or hint at things participants shouldn't hear.\n\nSo anything the interviewer must know goes into the study:\n\n- **A concept, requirement or feature you want reactions to:** write it into the question text, or attach an image to the question\n- **Terms the participant will use:** put them in the brief or the question wording\n- **Topics to dig into:** add them to the brief's topics, so the interviewer probes on them\n- **Things to stay away from:** add them as [guardrails](/docs/custom-ai-interviewer-persona)\n\nReview the brief before you publish with that in mind: if a detail matters for the interview and it only lives in a file, move it into the study.\n\n## Best Practices\n\n### Be Selective\n\nWith a limit of five files, prioritize quality over quantity. One well-written research summary is more useful than five loosely related documents.\n\n### Keep Documents Focused\n\nIf you have a 50-page report but only the executive summary and findings sections are relevant, consider extracting those sections into a separate document before uploading.\n\n### Update When Needed\n\nIf your context changes — for example, a new product feature launches between study design and interviewing — upload the new document and ask the research assistant to update the brief or the questions. The interview follows the study, so the change reaches participants only once it's in the brief or the questions.\n\n### Check What Made It Into the Brief\n\nAfter the research assistant drafts the study, read the brief and the questions as if you'd never seen your files. Whatever is missing there, the interviewer won't know.\n\n## Context Documents and Study Quality\n\nThink of context documents as a multiplier for study design. A well-designed study without context produces good results. The same study designed with relevant context produces sharper questions and a better-aimed brief. The context doesn't replace good [research question writing](/docs/writing-a-research-question) or thoughtful [work with the AI Consultant](/docs/working-with-the-ai-consultant) — it enhances both.\n\nIf you're new to Koji, it's perfectly fine to start without context documents and add them as you become more comfortable with the platform. Your first study doesn't need to be perfect — it needs to teach you something useful.\n\n## Related Articles\n\n- [Working with the AI Consultant](/docs/working-with-the-ai-consultant) — how context documents enhance the design conversation\n- [Understanding the Research Brief](/docs/understanding-the-research-brief) — what the brief contains and how to review it\n- [Structured Questions in AI Interviews](/docs/structured-questions-guide) — how context helps design better structured questions\n- [Editing the Brief Manually](/docs/editing-the-brief-manually) — making direct changes to the brief","category":"Study Design","lastModified":"2026-11-06T05:08:55.698278+00:00","metaTitle":"Uploading Context Documents — Koji Docs","metaDescription":"Learn how to add context files to your Koji study for smarter AI-generated questions and more relevant interviews.","keywords":["context documents","file upload","study design","background materials","AI context","research materials"],"aiSummary":"Context documents give Koji's research assistant background knowledge about your product, domain and earlier research while it designs your study. This guide covers supported formats (PDF, TXT, JSON, MD, up to 25 MB, five per study), what to upload, how files shape the brief and questions, and why the AI interviewer works only from the published study.","aiPrerequisites":["creating-your-first-study"],"aiLearningOutcomes":["Upload context documents to improve study design","Choose the most useful files from your available materials","Understand that context documents reach the research assistant and not the AI interviewer","Move anything the interviewer must know into the brief or the questions"],"aiDifficulty":"beginner","aiEstimatedTime":"6 min read"}],"pagination":{"total":1,"returned":1,"offset":0}}