Customizing Branding
How to personalize your interview landing page with custom headlines, descriptions, badges, mode settings, and OG images.
Every interview landing page can be tailored to match your brand and communicate the right message to participants. From the headline and description to trust badges and Open Graph images, the customize page gives you full control over first impressions.
Accessing the Customize Page
From your project dashboard, click on the Customize tab (or navigate to your project's customize page). This opens the editor where you can configure all the branding elements that participants see on your interview landing page.
The editor shows a live preview alongside the controls, so you can see exactly how your changes will look before saving.
What You Can Customize
Headline
The headline is the large text displayed prominently on the landing page. It is the first thing participants read, so make it count.
Default: Your project name.
Tips for good headlines:
- Focus on what the participant will be doing: "Share Your Onboarding Experience" is better than "Onboarding Research Study"
- Keep it under 60 characters for clean display on all screen sizes
- Use action-oriented language that invites participation
Examples:
- "Help Us Improve Your Checkout Experience"
- "Share Your Thoughts on [Product Name]"
- "Tell Us About Your Workflow"
Description
The description appears below the headline and provides context. This is where you explain the purpose of the interview and why the participant's input matters.
Tips:
- Keep it to two or three sentences
- Answer the question "Why should I participate?"
- Mention how the feedback will be used if possible
Example:
We are building the next version of our product and want to hear directly from people who use it daily. This short conversation helps us understand what is working well and where we can improve. Your feedback shapes what we build next.
Trust Badges
Trust badges are small visual indicators that reassure participants. Each badge has an icon and a label.
You can enable or disable badges and customize their labels. Available badge icons include:
| Icon | Common Use |
|---|---|
| Shield | Confidentiality / privacy |
| Clock | Estimated time |
| Star | Quality or special status |
| Check | Verified or confirmed |
| Lock | Security or anonymity |
| Heart | Appreciation or care |
Example badge sets:
- "Confidential" (Shield) + "5-10 minutes" (Clock) + "Anonymous" (Lock)
- "Quick & Easy" (Star) + "Takes 5 min" (Clock) + "Your voice matters" (Heart)
Badges appear in a horizontal row below the description on the landing page.
Interaction Mode Settings
Control which interview modes are available to participants:
- Both voice and text — participants choose their preferred mode (default)
- Voice only — the mode selector is hidden, participants go directly to voice
- Text only — the mode selector is hidden, participants go directly to text
- Default mode — if both are enabled, which mode is pre-selected
Voice mode requires that your project has a voice agent configured. If it does not, only text mode is available regardless of this setting.
Footer Text
Optional text that appears at the bottom of the landing page. Common uses include:
- Privacy notices
- Consent language
- Contact information for questions
- Legal disclaimers
Open Graph Images
Open Graph (OG) images control the preview that appears when your interview link is shared on social media, Slack, email, or messaging apps.
Why OG Images Matter
A link shared on LinkedIn or Slack with a custom preview image gets significantly more clicks than one with a generic or missing preview. If you are distributing your interview through social channels, configuring an OG image is one of the highest-leverage things you can do.
Setting Your OG Image
From the customize page, you can upload a custom image that will be used as the Open Graph preview. Recommended specifications:
- Dimensions: 1200 x 630 pixels (standard OG image size)
- Format: PNG or JPEG
- File size: Under 2 MB for fast loading
- Content: Include your brand logo, study title, or a visual that represents the research topic
If you do not upload a custom OG image, a default preview is generated using your project name and Koji branding.
Testing Your OG Preview
After uploading your image, you can test how it looks on different platforms:
- Share the link in a private Slack channel to see the preview
- Use a tool like the LinkedIn Post Inspector or Twitter Card Validator to preview the card
OG images are cached by platforms, so changes may take some time to propagate.
Saving Your Changes
The customize editor tracks unsaved changes and shows a save button when modifications are detected. Click Save to apply your changes. They take effect immediately — the next participant who visits your landing page will see the updated branding.
The live preview in the editor reflects your changes in real time, so you can iterate quickly before saving.
Branding and the Embed Widget
When your interview is loaded through the embed widget, the same branding settings apply. The headline, description, and badges render inside the iframe using the theme specified in the embed code (dark or light).
OG images are not relevant for embeds since the landing page is rendered inside the iframe rather than shared as a link.
Best Practices
- Write for your audience. If you are interviewing enterprise buyers, use professional language. If you are talking to Gen Z consumers, keep it casual and approachable.
- Show estimated time. A trust badge showing "5-10 minutes" or "Takes ~10 min" dramatically reduces drop-off.
- Be honest about purpose. Participants appreciate knowing why they are being interviewed. Vague descriptions lead to lower completion rates.
- Invest in the OG image. If social sharing is a key distribution channel, a branded preview image is worth the effort.
- Test on mobile. Open your interview link on your phone to see how the landing page looks on a smaller screen.
Next Steps
- Interview Landing Page — see how all these elements come together
- Publishing Your Study — make your customized interview live
- Intake Forms and Consent — add data collection before the interview starts
Related Articles
Embed Widget Reference
Technical reference for the Koji embed widget including iframe parameters and PostMessage API.
Using the Embed Widget
Add a Koji interview to your website using an embeddable iframe with configuration options and event listeners.
Interview Landing Page
The first thing participants see when they click your interview link — branded page with study details and mode selection.
Intake Forms and Consent
Collect participant information and consent before interviews begin with customizable form fields.
Publishing Your Study
What happens when you publish, what to check before going live, and how to share your interview link.
MCP Tool Reference — All 17 Tools
Complete reference for all 17 Koji MCP tools. Includes parameters, return data, plan requirements, and example prompts for each tool across read, create, analyze, customize, and distribute categories.