1. Implementing Recruiting
  2. Enable Vanity URL

Enable Vanity URL

You use a vanity URL to allow external candidates to access external career sites. A vanity URL is a descriptive, pronounceable, truncated URL that redirects users to a longer URL. It also extends an organization’s brand.

When you enable the Vanity URL feature, a vanity URL is used in the candidate journey in the career site, and in candidate facing communication. When a vanity URL is set, it's used across all career sites.

Here’s an example of how vanity URL works. Let’s say a company has the following web domain addresses: https//jobs.vision.com and https://www.vision.com/jobs.

  • Candidates visit https//jobs.vision.com or https://www.vision.com/jobs from their web browser.
  • The company web domain address is controlled by the customer, and the customer’s website sends the initial request. The company’s web server or content server responds to this request with static HTML content.
  • The HTML returned in Step 2 contains JavaScript that instructs the browser to load the career site application from Oracle HCM Cloud.
  • The JavaScript code replaces the browser content with the career site application from Oracle HCM Cloud. All subsequent actions from the career site are directly routed to Oracle HCM Cloud using REST service calls.

To enable a vanity URL, you need to:

  1. Create the Profile Option for Vanity URL
  2. Enable Vanity URL
  3. Set Up CORS
  4. Add HTML to Your Website
  5. Review Third-Party Integrations Setup
  6. Review Features Not Supporting Vanity URL
  7. Test the Configuration

Create the Profile Option for Vanity URL

You need to create and enable the profile option called IRC_VANITY_URL_ENABLED.

  1. In the Setup and Maintenance work area, click the Tasks icon.
  2. Click Search.
  3. Search for the task Manage Profile Options.
  4. Click the task name.
  5. On the Manage Profile Options page, click the New icon.
  6. On the Create Profile Option page, create the profile option by entering these values:

    • Profile Option Code: IRC_VANITY_URL_ENABLED

    • Profile Display Name: Vanity URL

    • Application: Recruiting

    • Module: Recruiting Common

    • Description: Enable the vanity URL feature in the Setup and Maintenance work area.

    • Start Date: Today's date

  7. Click Save and Close.

When the profile option is created, you need to enable it at the Site level.

  1. In the Setup and Maintenance work area, click the Tasks icon.
  2. Click Search.
  3. Search for the task Manage Administrator Profile Values.
  4. Click the task name.
  5. On the Manage Administrator Profile Values page, search for the profile option code IRC_VANITY_URL_ENABLED.
  6. Set the profile value at the Site level to Y.
  7. Click Save and Close.

For details, see Create and Edit Profile Options.

Enable Vanity URL

You need to enable the Vanity URL feature in the Setup and Maintenance work area.

  1. In the Setup and Maintenance work area, go to:

    • Offering: Recruiting and Candidate Experience

    • Functional Area: Recruiting and Candidate Experience Management

    • Task: Enterprise Recruiting and Candidate Experience Information

  2. Expand the Candidate Experience section and click Edit.

  3. Select the option Vanity URL.

  4. Enter the URL. Example: https://jobs.vision.com

  5. Disable the Keep Me Signed In feature. You can't use a vanity URL if this feature is enabled.

  6. Click Save.

Set Up CORS

  1. In the Setup and Maintenance work area, click the Tasks icon.
  2. Click Search.
  3. Search for the task Manage Administrator Profile Values.
  4. Click the task name.
  5. On the Manage Administrator Profile Values page, search for the profile option code ORA_CORS_ORIGINS.
  6. Go to the Profile Values section.
    • If the Site row already exists, make sure to retain the existing value and append the Vanity URL domain to it.
    • If the Site row doesn’t exist, create a Site Row and assign the Vanity URL domain.
  7. Ensure the value “self” is part of the profile option value. Here’s an example.
    Syntax Example
    'self' <vanityURL> 'self' https://jobs.vision.com
    'self' <optional - existingURLValue> <vanityURL> 'self' https://abc.previousvalues.com https://jobs.vision.com
  8. Make sure to only enter the vanity URL domain or subdomain; don’t include any portion of the relative path. Example:

    If the vanity URL domain is a separate subdomain such as https://jobs.vision.com, add https://jobs.vision.comand and https://vision.com to the profile option value.

    If the vanity URL domain includes a relative path such as https://www.vision.com/jobs, add https://www.vision.com and https://vision.com to the profile option value.

  9. Search for the profile option CORS_ACCESS_CONTROL_ALLOW_HEADERS.
  10. Go to the Profile Values section.
  11. Append these values to existing profile option value: ora-irc-language, ora-irc-access-code, ora-irc-validation-mode, ora-irc-vanity-domain, ora-irc-cx-userid, ora-irc-oauth-token, ora-irc-cx-timestamp
  12. Verify that you have entered the values exactly as specified. Make sure that there’s no extra blank space or missing hyphens.

  13. Click Save and Close.

Add HTML to Your Website

Work with your IT department to complete this step. You can use the Vanity URL HTML file sample as a guidance. For details, refer to the document Vanity URL HTML Sample on My Oracle Support (ID: 2855834.1).

You can use a domain such as www.visionjobs.com or a subdomain such as jobs.vision.com to host the external career site. In this case, place the HTML in your website’s root index page.

Alternatively, you can use a path-based domain such as careers.vision.com/jobs. This setup is appropriate when you have an existing career site that hosts your recruiting marketing content, and you can set up a relative path (/jobs) to host the jobs from the candidate experience site. In this case, place the HTML in the index page of your career website's relative path.

Make sure to replace the <<FUSION_CE_HOST_ADDRESS>> token used in the sample file, with CE host address in the HTML.

Warning: Don’t create a DNS CNAME entry pointing your domain and subdomain to Oracle’s Fusion Applications domain. This isn’t supported.

Review Third Party Integrations Setup

If you enabled LinkedIn Profile Import, make sure to add the vanity domain.

  1. In the Setup and Maintenance work area, go to:

    • Offering: Recruiting and Candidate Experience

    • Functional Area: Recruiting and Candidate Experience Management

    • Task: Recruiting Category Provisioning and Configuration

  2. On the Category Provisioning and Configuration page, go to the Profile Import section and click Edit.

  3. On the Profile Import Partners page, go to the Social Media section and review the LinkedIn details. Make sure you entered an allowlisted URL for the vanity domain.

  4. Click Save.

Review Features Not Supporting Vanity URL

Review the list of features that don’t work with Vanity URL.

  • Site preview on social media: The open graph tags won’t be recognized when your site uses vanity URL. Instead, you should add static open graph meta tags in the static HTML. For example, adding the following meta tags will result in the social media sites (such as LinkedIn or Facebook) to use the title, description, and image in the job posting link preview.

    <meta property="og:title" content=“Vision Careers">

    <meta property="og:description" content=“Explore exciting jobs at Vision">

    <meta property="og:image" content="http://careers.vision.com/thumbnail.jpg">

    <meta name="twitter:card" content="summary_large_image">

  • Keep me signed in: This feature isn’t compatible with the vanity URL feature. Turn off this feature if Vanity URL is enabled.
  • Career site links in site editor: All redirections from the editor to career sites or pages (for example, “Go To Site” link) won’t use the vanity URL; Fusion Application CE links will be used instead.
  • Job details page link copied from a requisition’s preview.

Test the Configuration

Test your configuration on a test or staging environment. Test all candidate facing use cases before enabling Vanity URL in production.

Related Topics