Free companion utility · Installation guide

OndaWorx Job SEO Links

OndaWorx Job SEO Links adds useful internal links to public job-detail pages. The links help visitors move from an individual job to related filtered Job Board searches and also provide additional crawlable internal links for search engines.

Free companion utility for OndaWorx Job Board customers OndaWorx Job SEO Links is supplied free to OndaWorx Job Board customers, but it is installed separately from the OndaWorx Job Board managed package. The SEO Links component and its Custom Metadata Types will therefore not appear in Salesforce until the separate SEO Links package supplied by OndaWorx has been installed.
Standalone by design Job SEO Links does not technically depend on the OndaWorx Job Board. It can also be configured against a customer's own Salesforce Job object and public Experience Cloud job pages.

1. What the component does

On an individual public Job Detail page, the component can display links such as: 

Looking for something else?

Locum Veterinary Jobs in South West England · Locum Veterinary Jobs · Veterinary Surgeon Jobs

Each link is a normal crawlable <a href> link. The links open in the same browser tab.

Job SEO Links does not create JobPosting structured data and does not change the canonical URL of the Job Detail page.

Job Detail SEO and Job SEO Links are different features. Job Detail SEO is built into the main OndaWorx Job Board package and controls items such as page metadata, canonical URLs and JobPosting structured data. Job SEO Links is the separate free companion utility described on this page.

2. Before you configure it

First make sure the separate OndaWorx Job SEO Links package has been installed in the Salesforce org.

Then identify the following information:

  • The API name of the Job object.
  • The field that represents the main Job category, profession or discipline.
  • The employment-type field, if used.
  • The county or local-area field, if used.
  • The region or state field, if used.
  • The field used to decide whether a Job is publicly available.
  • The exact value that represents a public Job.
  • The public Job Board search/list URL.
  • The URL parameters used by the public Job Board filters.
Do not begin configuration until the companion package is installed. If you cannot see OW SEO Link Config and OW SEO Link Template under Custom Metadata Types, confirm that the separate Job SEO Links package supplied by OndaWorx has been installed.

3. Create the main SEO Link Configuration record

In Salesforce Setup, open:

Custom Metadata Types → OW SEO Link Config → Manage Records

Create one configuration record for the customer's public Job Board.

Field What to enter
Label A clear customer or site name, for example Recruit4vets.
Developer Name A unique Salesforce-safe name, for example Recruit4vets. You will also enter this value in Experience Builder.
Enabled Tick this to make the configuration active.
Job Object The API name of the Job object. Examples: Job__c or OW_Job__c.
Category Field The API name of the profession, category or industry field.
Employment Type Field The API name of the employment-type or role-type field. Leave blank if it is not used.
County Field The API name of the county or local-area field. Leave blank if it is not used.
Region Field The API name of the state or region field. Leave blank if it is not used.
Published Field The API name of the field that determines whether the Job is publicly available.
Published Value Enter the exact value stored in the Published Field for a publicly available Job. Examples: true for a checkbox field, Open for a text or picklist status, or Published if that is the value used by the customer.
Base Search URL The public Job Board list/search page. Example: https://www.example.com/jobs.
Section Heading The heading shown above the links. Example: Looking for something else?.
Published Value must match the stored value. Do not assume it should be true. If the Published Field is a text or picklist field, inspect an existing live Job and use the value stored on that Job.
Use the Job Board search page as the Base Search URL. Do not use the URL of an individual Job Detail page. The Base Search URL must point to the public Job List or search page that accepts the filter parameters used by the link templates.

4. Create SEO Link Template records

In Salesforce Setup, open:

Custom Metadata Types → OW SEO Link Template → Manage Records

Create the links you want to appear on public Job Detail pages. Each template must be linked to the configuration record created above.

Field Purpose
Enabled Tick to make the template active.
Config Select the SEO Link Configuration record for this Job Board.
Sort Order Controls the order in which links appear. Lower numbers appear first.
Anchor Template The link wording displayed to the visitor.
URL Template The target URL using tokens and the customer's public Job Board search parameters.
Required Values A comma-separated list of values that must exist on the current Job before this link is displayed.

Supported tokens

Token Value
{BaseSearchURL} The Base Search URL from the main configuration record.
{Category} The current Job's configured category, profession or industry value.
{EmploymentType} The current Job's employment-type value.
{County} The current Job's county or local-area value.
{Region} The current Job's region or state value.

Token values used in URLs are encoded automatically. For example: IT & Technology becomes IT+%26+Technology.

Example template set

The exact search parameter names depend on the customer's public Job Board.

Sort Anchor Template URL Template Required Values
10 {EmploymentType} {Category} Jobs in {Region} {BaseSearchURL}?employment-type={EmploymentType}&category={Category}&region={Region} EmploymentType,Category,Region
20 {EmploymentType} {Category} Jobs {BaseSearchURL}?employment-type={EmploymentType}&category={Category} EmploymentType,Category
30 {Category} Jobs {BaseSearchURL}?category={Category} Category
Missing information is handled automatically. A template is not displayed if one of its Required Values is missing from the current Job. This prevents incomplete or misleading links from being shown.

5. Give the public site access

The public Experience Cloud guest user must be able to:

  • run the SEO Links Apex service
  • read the two SEO Links Custom Metadata Types
  • read the configured Job object and Job fields
  • access the public Job record being displayed

Open the Guest User Profile

  1. In Salesforce Setup, go to Digital Experiences → All Sites.
  2. Open the public Experience Cloud site.
  3. Open the site's Public Access Settings or Guest User Profile.

Enable the Apex class

  1. On the Guest User Profile, open Enabled Apex Class Access.
  2. Click Edit.
  3. Add: OWSeoLinkService
  4. Save.

Enable the Custom Metadata Types

  1. Return to the Guest User Profile.
  2. Open Enabled Custom Metadata Type Access.
  3. Click Edit.
  4. Enable:
    • OW SEO Link Config
    • OW SEO Link Template
  5. Save.
Do not use Experience Cloud Members for public guest access. The Members screen controls users who log in to the Experience Cloud site. Public Job Board visitors are not logged in, so the required access belongs on the site's Guest User Profile.
OndaWorx SEO Links Public permission set The separately supplied SEO Links package includes the OndaWorx SEO Links Public permission set containing the utility-specific Apex and Custom Metadata permissions. Where guest-user permission-set assignment is supported, it can be used. The Guest User Profile instructions above provide the clearest manual setup and can be used if direct guest assignment is not available.

The SEO Links utility does not grant broad access to the customer's Job data. The Guest User Profile must already have suitable Read access to the configured Job object and the Job fields used by the component.

6. Add the component in Experience Builder

  1. Open the customer's public Experience Cloud site in Experience Builder.
  2. Open the Job Detail page.
  3. Drag OndaWorx Job SEO Links onto the page.
  4. A common position is below the Job Detail content or Application Form.
  5. Select the component.
  6. In SEO Link Configuration, enter the exact Developer Name of the SEO Link Configuration record created earlier.
  7. Publish the Experience Cloud site.
There is no customer-specific default configuration. The component is deliberately supplied without customer-specific object names, field names or URLs. You must enter the Developer Name of a valid enabled SEO Link Configuration record in Experience Builder.

7. Test while signed out

Always test the finished component in a private or incognito browser window while signed out of Salesforce.

  1. Open a currently published Job Detail page.
  2. Confirm the SEO Links section appears.
  3. Confirm the wording matches the current Job.
  4. Click every link.
  5. Confirm each link opens the correct filtered Job Board results.
  6. Confirm the links open in the same browser tab.
  7. Test a Job with a missing optional value and confirm unsuitable links are omitted.
  8. Test an unpublished or inaccessible Job and confirm the SEO Links are not exposed.
If the component is blank everywhere Check the configuration first. In particular check: Published Field, Published Value, the configured field API names, whether the configuration is enabled, and whether the templates are linked to the correct configuration.

8. Troubleshooting

Symptom Check
I cannot see OW SEO Link Config, OW SEO Link Template or the SEO Links component. Confirm that the separate OndaWorx Job SEO Links companion package supplied by OndaWorx has been installed. These components are not part of the main Job Board managed package.
The component is blank only when signed out. Check the Guest User Profile has access to OWSeoLinkService, OW SEO Link Config, OW SEO Link Template, the configured Job object and fields, and the public Job record.
The component is blank in Builder and on the public page. Check that the configuration is enabled, Experience Builder contains the exact configuration Developer Name, and Published Value matches the value stored on a live Job.
Only some links appear. Check the template's Required Values and the corresponding values on the current Job.
A link opens the wrong Job results. Check the URL Template parameter names against the customer's actual public Job Board filters.
The links still point to an old Job Board URL. Edit the main SEO Link Configuration record and update Base Search URL. Templates using {BaseSearchURL} will use the new address automatically.

9. What the utility does not change

  • It does not alter the main OndaWorx Job Board package.
  • It does not change Job Detail canonical URLs.
  • It does not generate JobPosting structured data.
  • It does not submit Job URLs to Google.
  • It does not depend on AI or an external API.
  • It does not hard-code customer Job objects or field names.
  • It does not hard-code customer public Job Board URLs.
Setup complete The OndaWorx Job SEO Links component should now display useful, crawlable internal links on eligible public Job Detail pages. Keep the configuration with the customer's implementation records so future administrators know which Job fields and search URLs are being used.

OndaWorx Job SEO Links — free companion utility setup guide.