> ## Documentation Index
> Fetch the complete documentation index at: https://docs.houra.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Creating and Managing Job Listings on Houra Empleo

> Publish branded job listings on your Houra Empleo portal in minutes — add titles, requirements, and benefits to attract the right candidates.

Your Houra Empleo portal is your organization's public face for hiring. Every listing you publish appears there instantly, complete with your logo and branding, so candidates get a professional, consistent experience before they even click "Apply." You control every detail — from job title and requirements to the benefits you highlight — and you can update or unpublish a listing at any time directly from the admin panel.

## How your public portal works

Each organization on Houra gets a unique Empleo URL. When candidates visit it, they see all of your currently active listings in one place. Clicking a listing opens the full job detail page, which includes the description, requirements, and benefits you've written, along with your company logo and name. Candidates apply directly from that page — no account required, no third-party platform involved.

<Info>
  Your portal URL is tied to your organization and is always active. Only listings you've explicitly published appear to candidates — drafts and unpublished roles stay hidden.
</Info>

## Creating a job listing

<Steps>
  <Step title="Open the Recruitment module">
    In the Houra admin panel, navigate to **Recruitment** and click **New listing**.
  </Step>

  <Step title="Add the job title and basic details">
    Enter the job title, department, location, and employment type (full-time, part-time, contractor, etc.). These details appear at the top of your public listing.
  </Step>

  <Step title="Write the description, requirements, and benefits">
    Use the rich-text editor to write a clear job description. Add a bulleted list of requirements and a separate section for benefits. The more specific you are, the better-fit candidates you will attract.
  </Step>

  <Step title="Add your company branding">
    Upload your company logo if it isn't already set, and confirm the branding details for this listing. Your logo appears prominently on the public listing and the application form.
  </Step>

  <Step title="Attach a custom application form">
    Select an existing form or create a new one (see [Applications](/careers/applications) for details). Every candidate who applies to this role will fill out this form.
  </Step>

  <Step title="Publish the listing">
    Click **Publish**. The listing goes live on your Houra Empleo portal immediately and is visible to anyone with the portal link.
  </Step>
</Steps>

<Tip>
  Complete job descriptions — with specific requirements, clear responsibilities, and a genuine benefits section — consistently attract better-fit candidates and reduce time spent screening applicants who aren't a match.
</Tip>

## Adding your company logo and branding

Your logo is set at the organization level in **Settings → Branding**. Once uploaded, it appears automatically on every listing and application form in your Empleo portal. If you want to update your logo, change it in Settings and all listings will reflect the new version immediately.

<Note>
  Branding is applied consistently across all your listings. You cannot set a different logo per listing — the organization-level logo is always used.
</Note>

## Editing a published listing

To edit a live listing, navigate to **Recruitment → Listings**, click the listing you want to update, and make your changes. Edits are saved and reflected on the public portal as soon as you click **Save**. Candidates who visit the listing after you save will see the updated content.

<Warning>
  Editing a published listing updates it for everyone, including candidates who may have bookmarked the page. If you need to make major changes to a role, consider unpublishing it first, updating the details, then republishing.
</Warning>

## Unpublishing a listing

When a role is filled or no longer available, go to **Recruitment → Listings**, click the listing, and click **Unpublish**. The listing is immediately removed from your public Empleo portal. Existing applications and candidate data are preserved — unpublishing only hides the role from new applicants.