XML Guide: Stepstone [DE]

Document Structure

Each XML document starts with the XML declaration using UTF-8 encoding:

<?xml version="1.0" encoding="UTF-8"?>

After the XML declaration, the document contains the root element /jobfeed. The allowed number of joblisting elements depends on the integration type:

• PUSH Integration: The document must contain exactly one joblisting. See the PUSH Integration documentation.
• PULL Integration: The document must contain one or more joblisting elements. The XML feed is made available through a URL and retrieved by StepStone. See the PULL Integration documentation.

Element order inside each joblisting is significant because the schema uses xs:sequence. Produce child elements in the order shown in this guide.

Account Identification

Providing both company_id and user_id is recommended. When both identifiers are present, companydetails/companyname remains optional. If either identifier is missing, a non-empty companydetails/companyname must be supplied.

The company_id and user_id are provided by StepStone.

If jobs need to be submitted using only a company name and without company_id and user_id credentials, this feature must first be enabled by StepStone. Contact the Helpdesk team at helpdesk-jobfeed@stepstone.de to request activation.

When this feature is enabled, StepStone assigns the submitted job to the corresponding account and user. This additional assignment step may cause a delay in job posting because of additional validation steps.

Node Reference

Every parent node, child node, and attribute is listed below. The XPath is shown below each node name.

Allowed Values

The restricted values in this section are accepted case-insensitively. For example, INSERT, insert, and Insert are accepted for the action value.

Implementation Rules

• Company identification: send both company_id and user_id where available. If either is missing, send a non-empty companydetails/companyname.
• Application target: apply must contain exactly one child: email or url.
• Salary: salary is optional. When included, send minimum, maximum, currency, and period. minimum must be strictly less than maximum.
• Locations: send between one and five location elements. Each requires countrycode and city.
• Categorization: all direct categorization children are optional and repeatable.
• Header images: send zero to three header elements.
  • Recommended minimum dimensions: 1140px × 456px.
  • Recommended aspect ratio: 5:2.
  • Recommended file size: approximately 500 KB.
  • Supported formats: JPG, JPEG, and PNG.
• Video: when included, the URI must contain youtube, youtu.be, vimeo, or wistia, case-insensitively.
• CDATA: CDATA is recommended when using special characters, umlauts, or supported HTML markup. If CDATA is not used, special characters and umlauts must be encoded as numeric XML character references, for example Ä for Ä or ä for ä. Named HTML entities such as ä are not valid in XML unless they are declared in a DTD.

The following HTML tags are supported in introduction, tasks, profile, weoffer, and additionalinfo.

HTML tags that are not listed as supported are automatically filtered out by Stepstone.

XML Validator

Paste a complete JobFeed XML document below and select Validate XML. The validator supports PUSH documents with exactly one joblisting and PULL documents with one or more joblisting elements. It validates every joblisting separately and lists every detected issue.

Changelog