{"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-05-18T13:32:46.772Z"},"content":[{"type":"documentation","id":"1cf9603b-b062-4295-8cbb-07937d8b01ed","slug":"publishing-your-study","title":"Publishing Your Study","url":"https://www.koji.so/docs/publishing-your-study","summary":"Publishing transforms your research brief into a live AI interviewer with voice agents, assigns stable question IDs, and generates a shareable interview link. This guide covers publishing requirements (problem statement, target participant, key questions), a pre-publish checklist, and post-publish management.","content":"Publishing is the moment your study goes from a design document to a live research instrument. When you hit publish, Koji takes your [research brief](/docs/understanding-the-research-brief) and creates an AI interviewer that's ready to have conversations with your participants. It also generates a unique interview link you can share immediately.\n\n## What Happens When You Publish\n\nPublishing triggers several things behind the scenes:\n\n### 1. Your AI Interviewer Is Created\n\nKoji takes everything in your research brief — the problem context, methodology, target participant description, interview questions, probes, guardrails, and any [context documents](/docs/uploading-context-documents) you uploaded — and configures an AI interviewer specifically for your study. This interviewer knows your research goals, follows your chosen methodology, uses the questions you approved, and adapts its probing based on participant responses.\n\nThe interviewer is unique to your study. It's not a generic chatbot — it's a purpose-built research conversationalist designed to execute your study plan.\n\n### 2. Voice Agents Are Created (If Enabled)\n\nIf your study has voice interviews enabled, Koji automatically creates dedicated voice agents for each language your study supports. These voice agents handle the conversational flow, structured question capture, and real-time probing — all through natural speech. Voice agent creation happens automatically during publishing; no additional configuration is needed.\n\n### 3. Question IDs Are Assigned\n\nEach [structured question](/docs/structured-questions-guide) in your study receives a stable identifier at publish time (if one hasn't already been assigned). These IDs flow through from the brief to the interview to the report, ensuring that your aggregate data — charts, distributions, averages — accurately maps responses across all interviews, even if question text is lightly edited later.\n\n### 4. Your Interview Link Is Generated\n\nYou receive a unique URL that you can share with participants. When someone opens this link, they're taken directly into the interview experience. No accounts, no downloads, no friction — just a conversation.\n\nYou can share this link via email, embed it in a recruitment message, post it in a community, or distribute it however you normally reach participants. For more on distribution strategies, see [Sharing Your Interview Link](/docs/sharing-your-interview-link).\n\n### 5. Your Study Becomes Active\n\nOnce published, your study moves to an active state. Interviews can begin happening at any time — whenever a participant clicks the link. You'll be able to monitor incoming responses from your dashboard.\n\n## Requirements for Publishing\n\nKoji checks that your research brief has the essential components before allowing you to publish. Your brief needs:\n\n- **A problem statement** — the core question or goal your study addresses\n- **Target participant information** — at minimum, either the required experience or behavior of interest must be defined so the AI knows who it's talking to\n- **Key questions** — at least a core set of questions for the AI interviewer to follow\n\nNote that a methodology is helpful but not strictly required for publishing. If you haven't selected one, the AI interviewer will use sensible defaults based on your questions and problem statement.\n\nIf any required fields are missing or incomplete, Koji will prompt you to fill them in before publishing. This safeguard ensures every live study has enough structure to produce meaningful conversations. For more on how this validation works, see [How the Quality Gate Works](/docs/how-the-quality-gate-works).\n\n## Pre-Publish Checklist\n\nBefore you hit publish, take a few minutes to review your study end-to-end. Once interviews start, you'll want to be confident that everything is right. Here's what to check:\n\n### Research Brief Review\n\n- [ ] **Problem statement** — Does it clearly and accurately describe what you want to learn?\n- [ ] **Target participant** — Is the description specific enough that you could use it as a recruitment screener? Does it focus on behavior and experience rather than demographics?\n- [ ] **Interview questions** — Read every question out loud. Do they flow naturally? Are they open-ended and non-leading?\n- [ ] **Structured questions** — Are scale ranges appropriate? Do choice options cover the likely answers? Are ranking items clear? See the [structured questions guide](/docs/structured-questions-guide) for configuration tips.\n- [ ] **Probing configuration** — Do follow-up questions dig into the right areas? Is anchor probing enabled on key scale questions?\n- [ ] **Question count** — Is the total number of questions realistic for your target interview length?\n- [ ] **Language** — Would your target participants understand and feel comfortable with the way questions are worded?\n\n### Context and Settings\n\n- [ ] **Context documents** — Have you uploaded any relevant background materials? Are they current and accurate?\n- [ ] **Interview length** — Is the target duration appropriate for the depth of questions you're asking?\n- [ ] **Interview mode** — Is the mode (structured, exploratory, or hybrid) appropriate for your research goals?\n\n### Interview Experience\n\n- [ ] **Interview mode** — Are you using voice, text, or both? Make sure the experience matches your participants' expectations. Learn more about [voice interviews](/docs/voice-interview-experience) and [text interviews](/docs/text-interview-experience).\n- [ ] **Branding** — Have you [customized the look and feel](/docs/customizing-branding) of the interview page to match your brand?\n\n### Logistics\n\n- [ ] **Recruitment plan** — Do you know how you'll share the interview link? Do you have your participant list ready?\n- [ ] **Timeline** — When do you need results? Allow time for participants to complete interviews at their own pace.\n- [ ] **Team awareness** — Does your team know the study is going live? Will they be monitoring incoming results?\n\n## How to Publish\n\nOnce you're satisfied with your review:\n\n1. Open your study in the design workspace\n2. Review the research brief one final time in the artifact panel\n3. Click the publish button\n4. Koji validates your brief, assigns question IDs, creates the AI interviewer (and voice agents if enabled)\n5. Your interview link is generated and ready to share\n\nThe process takes just a moment. Once published, you'll see your interview link prominently displayed so you can start sharing it right away.\n\n## After Publishing\n\nOnce your study is live, here's what to expect:\n\n### Monitoring Responses\n\nAs participants complete interviews, their responses appear in your study dashboard. You can review individual conversations, see how many interviews have been completed, and start identifying patterns. Structured question responses are automatically aggregated — you'll see charts and distributions building up as more participants respond.\n\n### Making Changes After Publishing\n\nIf you discover an issue with your study after publishing, you have options:\n\n- **Minor adjustments** — You can update certain settings without unpublishing\n- **Significant changes** — For substantial modifications to the research brief, you'll need to unpublish, make changes, and republish. Be aware that any interviews conducted before the change used the original brief.\n\n**Important:** If you've already collected some interviews, think carefully before changing the brief. Mixing data from different versions of the interview can complicate your analysis. In many cases, it's better to finish the current round, analyze what you have, and create a new study for the revised approach.\n\n### Pausing and Resuming\n\nIf you need to temporarily stop accepting new interviews — perhaps to review early results before continuing recruitment — you can unpublish the study. The interview link will stop working, and existing data is preserved. When you're ready to continue, simply republish.\n\n## Common Scenarios\n\n### \"I published but want to change one question\"\n\nIf no interviews have been completed yet, unpublish, make the change, and republish. The same interview link will work. If interviews are already in, consider whether the change is significant enough to warrant starting fresh.\n\n### \"My interview link isn't working\"\n\nMake sure your study is in a published (active) state. If you recently made changes and republished, the link should still be the same. If you're sharing the link and participants are having trouble, check that you're copying the full URL.\n\n### \"I want to run the same study with a different participant group\"\n\nThe best approach is to create a new study. You can use your existing study as a starting point and adjust the target participant description and any participant-specific questions. This keeps your data clean and your analysis straightforward.\n\n### \"I'm not sure if my study is ready\"\n\nIf you're unsure, go through the pre-publish checklist above. You can also ask the [AI Consultant](/docs/working-with-the-ai-consultant) to review your brief one more time — say something like \"Can you review the brief and flag anything I should fix before publishing?\" It's always better to spend an extra ten minutes reviewing than to discover an issue after interviews are underway.\n\n## Next Steps\n\nOnce your study is published, it's time to get participants. Check out these guides for what comes next:\n\n- [Sharing Your Interview Link](/docs/sharing-your-interview-link) — strategies for distributing your link and recruiting participants\n- [Customizing Branding](/docs/customizing-branding) — making the interview experience feel like your brand\n- [Voice Interview Experience](/docs/voice-interview-experience) — what participants experience in voice mode\n- [Text Interview Experience](/docs/text-interview-experience) — what participants experience in text mode\n- [How the Quality Gate Works](/docs/how-the-quality-gate-works) — understanding the publish validation process\n\n## Further reading on the blog\n\n- [How to Run AI-Powered Customer Interviews at Scale](/blog/how-to-run-ai-powered-customer-interviews-at-scale) — Learn how to conduct effective customer interviews at scale using AI. This comprehensive guide covers everything from planning and question \n- [Why AI Interviewers Are the Future of Customer Research](/blog/why-ai-interviewers-are-the-future-of-customer-research) — AI interviewers are transforming how product teams conduct customer research, enabling conversations at scale without sacrificing depth or q\n\n<!-- further-reading:blog -->\n","category":"Study Design","lastModified":"2026-05-13T00:25:38.788654+00:00","metaTitle":"Publishing Your Study — Koji Docs","metaDescription":"Learn what happens when you publish a Koji study, what to check before going live, and how to manage your active study.","keywords":["publish study","interview link","AI interviewer","go live","study launch","pre-publish checklist"],"aiSummary":"Publishing transforms your research brief into a live AI interviewer with voice agents, assigns stable question IDs, and generates a shareable interview link. This guide covers publishing requirements (problem statement, target participant, key questions), a pre-publish checklist, and post-publish management.","aiPrerequisites":["understanding-the-research-brief"],"aiLearningOutcomes":["Understand what happens when a study is published","Review a study using the pre-publish checklist","Manage a live study including pausing and making changes","Handle common post-publish scenarios"],"aiDifficulty":"beginner","aiEstimatedTime":"7 min read"}],"pagination":{"total":1,"returned":1,"offset":0}}