Roles

Before you start

Before creating your first role, you need to set up your organization. Go to Organization in the sidebar and add your company name and logo. This information appears on your challenge pages and candidate-facing content.

Creating a role

1. 1

   Click Create Role from the Roles page (or + New Role if you already have roles).

2. 2

   Enter the job title (e.g., "Senior Frontend Engineer"). Keep it under 50 characters — this appears on the challenge page header.

3. 3

   Choose whether this role is for your organization or for a client (if you're an agency or recruiter hiring on behalf of another company).

Role detail page

After creating a role, you'll land on the role detail page. This is your hub for managing everything about this role — the job description, requirements, challenge, content, preview, and responses.

The sidebar navigation shows each step in the workflow:

• General — job title, company selection, role status
• Requirements — upload job description (PDF or text) to seed AI insights
• Challenge — select or generate a challenge question
• Content — intro script, key highlights, branding, video
• Preview — see how the challenge page looks before publishing
• Responses — review candidate submissions

Locked tabs (shown with a lock icon) unlock as you complete earlier steps. For example, Content unlocks after you select a challenge question.

Adding a job description

The Requirements tab is where you upload the job description. This is the most important step — the quality of your AI-generated challenge questions depends directly on the context you provide here.

You can provide the job description in two ways:

Role Insights

Once a job description is uploaded, McCoy's AI automatically generates Role Insights — an analysis of the role covering:

• Key competencies and skills to evaluate
• What distinguishes strong candidates for this specific role
• Potential interview angles and conversation starters
• Industry context and role-specific considerations

Role Insights generation takes a few seconds and happens automatically. These insights power the challenge question recommendations — you don't need to read them, but they're available if you want to review what the AI understands about the role.

Role status

Each role has a status shown on the Roles page:

• Draft (yellow) — the challenge hasn't been published yet. You're still setting up.
• Open (green) — the challenge is published and accepting responses.
• Closed (red) — the role is closed and no longer accepting responses.

You can close a role from the General tab by clicking Close Role. Closed roles and their responses are preserved — you can view them anytime, but no new responses will be accepted. You can reopen a closed role later.