Enable Vanity URL

You use a vanity URL to allow external candidates to access 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 a profile option called IRC_VANITY_URL_ENABLED.
  2. Enable the profile option IRC_VANITY_ URL_ENABLED.
  3. Enable the Vanity URL feature.
  4. Set up CORS.
  5. Add HTML to your website.
  6. Review third-party integrations setup.
  7. Review features not supporting Vanity URL.
  8. Test the configuration.

Create Profile Option

You need to create a profile option called IRC_VANITY_URL_ENABLED.

  1. Go to the Setup and Maintenance work area.
  2. Click the Tasks icon.
  3. Click Search.
  4. On the Search page, search for the task Manage Profile Options.
  5. On the Manage Profile Options page, click the Create icon.

  6. On the Create Profile Option page, create the profile 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.

You're back on the Manage Profile Options page and the profile option IRC_VANITY_URL_ENABLED is displayed. You need to enable the profile option at the Site level.

  1. On the Manage Profile Options page, go to the Profile Option Levels section.

  2. Set the profile option to be enabled and updatable at the Site level.

  3. Click Save and Close.

Enable Profile Option

You need to enable the profile option IRC_VANITY_URL_ENABLED so that the Vanity URL feature becomes available in the Recruiting and Candidate Experience offering.

  1. Go to the Setup and Maintenance work area.
  2. Click the Tasks icon.
  3. Click Search.
  4. On the Search page, search for the task Manage Administrator Profile Values.
  5. On the Manage Administrator Profile Values page, search for the profile option code IRC_VANITY_URL_ENABLED.

  6. Set the profile value to Y.

  7. Click Save and Close.

Enable Vanity URL Feature

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. In the Corporate Branding section, select Active for the Vanity URL option.

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

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

  5. Click Save and Close.

Set Up CORS

  1. Go to the Setup and Maintenance work area.
  2. Click the Tasks icon.
  3. Click Search.
  4. On the Search page, search for the task Manage Administrator Profile Values.
  5. Search for the profile option code ORACLE.ADF.VIEW.ALLOWED_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, see Vanity URL HTML Sample on My Oracle Support (Document 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.

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.

Test the Configuration

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