Import and export

The CvasYouAre XML format

Structure of cv-data.xml, the file attached to every CvasYouAre PDF: schema, rules and full element reference.

Updated 23/10/2026

Every PDF generated by CvasYouAre contains an attachment named cv-data.xml with all the data of the CV. It makes your CV portable: you can import the PDF (or the XML on its own) back into CvasYouAre, and any program can read it.

Where to find it

  • Open the PDF in a reader that shows attachments (Adobe Acrobat Reader: paperclip icon in the side panel; Firefox and Chrome: attachments panel) and save cv-data.xml.
  • To import it: Import CV on the website, then upload the PDF or the XML file (max 10 MB). Europass XML files are accepted too.

Schema and namespace

  • Namespace: https://www.cvasyouare.com/cv/schema/v1
  • XML Schema (XSD), public: /cv/schema/v1 (same address as the namespace)
  • Root element: CvDocument with attribute version="1.0"
  • Encoding: UTF-8

The file declares its schema with xsi:schemaLocation, so validators and XML editors find it on their own:

<?xml version="1.0" encoding="utf-8"?>
<cv:CvDocument version="1.0"
    xmlns:cv="https://www.cvasyouare.com/cv/schema/v1"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="https://www.cvasyouare.com/cv/schema/v1 https://www.cvasyouare.com/cv/schema/v1">
  <cv:Metadata>
    <cv:Id>3f2a…</cv:Id>
    <cv:Language>English</cv:Language>
    <cv:ExportDate>2026-10-23T16:33:53.7376411Z</cv:ExportDate>
    <cv:ExportedBy>CvasYouAre v1.0</cv:ExportedBy>
  </cv:Metadata>
  <cv:Summary>
    <cv:Title>Senior Developer</cv:Title>
    <cv:Description>Ten years of .NET…</cv:Description>
    <cv:Notes />
  </cv:Summary>
  <cv:PersonalData>
    <cv:Name>Mario</cv:Name>
    <cv:Surname>Rossi</cv:Surname>
    <cv:Email>mario@example.com</cv:Email>
    <cv:BornDate>1985-04-12</cv:BornDate>
    <cv:ProfileImage encoding="base64">data:image/png;base64,iVBORw0…</cv:ProfileImage>
  </cv:PersonalData>
  <cv:WorkExperienceList>
    <cv:WorkExperience>
      <cv:Position>Developer</cv:Position>
      <cv:Employer>Acme</cv:Employer>
      <cv:DateFrom>2020-01-01</cv:DateFrom>
      <cv:DateTo />
    </cv:WorkExperience>
  </cv:WorkExperienceList>
  …
</cv:CvDocument>

Rules

  • Order: inside each element, children can appear in any order.
  • Empty values: optional fields can be empty (<cv:Phone />); CvasYouAre always writes every element, even when empty.
  • Dates: yyyy-MM-dd. An empty DateTo means "ongoing". ExportDate is an ISO 8601 date-time in UTC.
  • CV language (Metadata/Language): English, Italian, French, Spanish or German.
  • Language levels (Read, Write, Listen, Conversation, Interaction): CEFR scale A1, A2, B1, B2, C1, C2.
  • Profile photo: image in base64, usually as a data URI (data:image/jpeg;base64,…), with attribute encoding="base64".
  • Notes (Summary/Notes) is the internal CV name: in the XML attached to PDFs it is always empty, because the PDF is meant to be sent to recruiters.
  • Files created before October 2026 use the older namespace http://cvasare.com/cv/schema/v1: CvasYouAre still imports them.

Element reference

Generated from the published XSD: every element, its content and whether it is required.

CvDocument

ElementContentPresence
Metadatagroup (see below)required
PersonalDatagroup (see below)required
Summarygroup (see below)optional
WorkExperienceListlist (see below)optional
EducationListlist (see below)optional
LanguageListlist (see below)optional
SkillListlist (see below)optional
CertificationListlist (see below)optional
PublicationListlist (see below)optional
ReferenceListlist (see below)optional

CvDocument/Metadata

ElementContentPresence
Idtextrequired
Languagetextoptional
ExportDatedate-time ISO 8601required
ExportedBytextoptional

CvDocument/PersonalData

ElementContentPresence
Nametextoptional
Surnametextoptional
Emailtextoptional
Phonetextoptional
Mobiletextoptional
Addresstextoptional
Nationtextoptional
BornDatedate yyyy-MM-dd or emptyoptional
Sextextoptional
Webtextoptional
DriveLicensetextoptional
ProfileImagebase64 image (encoding="base64")optional

CvDocument/Summary

ElementContentPresence
Titletextoptional
Descriptiontextoptional
Notestextoptional

CvDocument/WorkExperienceList/WorkExperience

ElementContentPresence
Positiontextrequired
Employertextrequired
AreaOfWorktextoptional
Commenttextoptional
DateFromdate yyyy-MM-ddrequired
DateTodate yyyy-MM-dd or emptyoptional

CvDocument/EducationList/Education

ElementContentPresence
Institutetextrequired
Qualificationtextrequired
Gradetextoptional
DateFromdate yyyy-MM-ddrequired
DateTodate yyyy-MM-dd or emptyoptional

CvDocument/LanguageList/Language

ElementContentPresence
LanguageNametextrequired
Readtextoptional
Writetextoptional
Listentextoptional
Conversationtextoptional
Interactiontextoptional

CvDocument/SkillList/Skill

ElementContentPresence
Typetextrequired
Descriptiontextrequired

CvDocument/CertificationList/Certification

ElementContentPresence
CertificationNametextrequired
Companytextoptional
Logotextoptional

CvDocument/PublicationList/Publication

ElementContentPresence
Typetextoptional
Titletextrequired
Publishertextoptional
Yeartextoptional
Collaborationtextoptional
Isbntextoptional
Languagetextoptional

CvDocument/ReferenceList/Reference

ElementContentPresence
ReferentNametextoptional
ReferentSurnametextoptional
ReferentRoletextoptional
ReferentCompanytextoptional
ReferentEmailtextoptional
ReferentPhonetextoptional
ReferenceDescriptiontextoptional
LinkDescriptiontextoptional