New

Now in Claude, ChatGPT, Cursor & more with our MCP server

Back to docs
Collecting Responses

Customizing Interview Slugs

Personalize your interview URL with a memorable, branded slug that participants can trust.

Your interview slug is the last part of the URL that participants see when they click your link. Customizing it makes the link more memorable, more professional, and more trustworthy. Instead of a random identifier, your link can read /i/acme-product-feedback or /i/2024-ux-study.

What Is an Interview Slug?

Every Koji interview has a URL in this format:

https://yourdomain.com/i/your-slug-here

The slug is the your-slug-here portion. When you create a new project, Koji generates a default slug based on your project name. You can change it at any time.

How to Change Your Slug

  1. Open your project from the dashboard.
  2. Find your interview link displayed near the top of the project page.
  3. Click the edit (pencil) icon next to the slug.
  4. Type your new slug.
  5. Click Save.

Koji validates the new slug immediately. If the slug is already taken by another project, you will see an error message and need to choose a different one.

Slug Format Rules

Slugs must follow these rules:

  • Lowercase letters only — uppercase letters are not allowed
  • Numbers are fine2024-study works perfectly
  • Hyphens for separators — use hyphens instead of spaces or underscores
  • No special characters — only a-z, 0-9, and - are permitted

Examples of valid slugs:

acme-feedback
product-research-q1
ux-study-2024
customer-interviews

Examples of invalid slugs:

Acme_Feedback      (uppercase and underscores)
my study           (spaces)
research@acme      (special characters)

Best Practices for Memorable Slugs

Keep It Short and Descriptive

The best slugs are short enough to remember but descriptive enough to convey purpose. Aim for two to four words separated by hyphens.

Good: acme-feedback, product-research, onboarding-study Too long: acme-corporation-quarterly-product-feedback-survey-2024 Too vague: study, interview, research

Include Your Brand

If you are sharing the link externally, including your brand name or a recognizable shorthand helps participants feel confident they are clicking a legitimate link.

acme-feedback
myapp-ux-research
widgets-customer-voice

Add Context

If you run multiple studies, add a distinguishing element like the topic, quarter, or audience:

acme-onboarding-q1
acme-pricing-feedback
acme-enterprise-interviews

Think About Sharing

When your link is shared on social media or in a message, the slug is visible to everyone. A clean, professional slug reflects well on your study and your brand.

Links that look like /i/acme-product-feedback inspire more confidence than /i/x7f92k3.

When to Change Your Slug

You can change your slug at any time, but keep these considerations in mind:

  • Before sharing: Ideally, set your final slug before you distribute the link. This avoids the need to resend links or update references.
  • Active links break: If participants have already received the old link, changing the slug means those links will no longer work. The old slug becomes available for other projects.
  • Imported participants: If you have already imported participants via CSV, their unique tracking links include the slug. Changing the slug will break those links.

The safest approach is to finalize your slug before publishing your study and distributing links.

Slug Availability

Slugs are unique across your account. Two projects cannot share the same slug. If you try to use a slug that is already in use, Koji will display an error and ask you to choose a different one.

If you delete or archive a project, its slug becomes available again after a short cooldown period.

How the Slug Affects SEO and Open Graph

When someone shares your interview link on social media, the Open Graph preview uses your branding settings — headline, description, and OG image. The slug itself appears in the URL preview, so a descriptive slug like /i/acme-product-feedback looks more clickable than a random string.

Search engines generally do not index interview pages (they require interaction to be useful), so SEO is not a primary concern here. The slug's value is purely in human readability and trust.

Troubleshooting

"Slug is already taken"

Another project in your account is using this slug. Choose a different one or archive the other project to free it up.

"Invalid slug format"

Your slug contains characters that are not allowed. Use only lowercase letters, numbers, and hyphens. Remove any spaces, underscores, or special characters.

Links stopped working after changing the slug

The old slug is no longer active. Update any shared links or email templates to use the new slug. For participants who already received the old link, you will need to resend the updated URL.

Next Steps