View source for XMP help for Adobe applications

[[Category:Technology]]
[[Category:Developer]]
[[Category:XMP]]
[[Category:metadata]]
You are here because you want to use an Adobe application like Photoshop to mark files as re-usable under a Creative Commons license.

Many Adobe applications support embedding [[XMP]] metadata in files, most notably PDF documents.  The Creative Commons [http://www.creativecommons.org/license/ licensing process] offers an [[XMP]] template which may be used to mark documents with Creative Commons license information.

Note that a licensed PDF document should include a visible copyright notice as described in [[HOWTO Tag HTML pages|how to tag works]] in addition to embedded metadata.

{{Infobox|Only Photoshop CS has been well tested.  Problems have been reported getting Acrobat 6.0 to select downloaded XMP templates. Acrobat 5.0 does not support a UI for embedding XMP. Photoshop CS can embed XMP in PDFs via its [[#multiple|file browser]].}}

= How to tag a single file =

== Step 1: Choose a license ==

Click on "choose license" on most pages at creativecommons.org to visit the [http://www.creativecommons.org/license/ license selection application].

== Step 2: Create an XMP template ==

In order to mark you work you need an XMP template.  You can create this using a text editor.  Use the following text, replacing '''LICENSE_URL''', '''YOUR_NAME''' and '''LICENSE_NAME''' with the appropriate values.  

For example, if a user chose [http://staging.creativecommons.org/license/results-one?q_1=2&q_1=1&field_commercial=yes&field_derivatives=yes&field_jurisdiction=&field_format=&field_worktitle=&field_attribute_to_name=&field_attribute_to_url=&field_sourceurl=&field_morepermissionsurl=&lang=en_US&language=en_US&n_questions=3 Attribution 3.0] they would replace '''LICENSE_URL''' with <code>http://creativecommons.org/licenses/by/3.0/</code>, '''LICENSE_NAME''' with <code>Attribution 3.0</code> and '''YOUR_NAME''' with the user's name.

<code><pre>
<?xpacket begin='' id=''?><x:xmpmeta xmlns:x='adobe:ns:meta/'>
    <rdf:RDF xmlns:rdf='http://www.w3.org/1999/02/22-rdf-syntax-ns#'>

     <rdf:Description rdf:about=''
      xmlns:xapRights='http://ns.adobe.com/xap/1.0/rights/'>
      <xapRights:Marked>True</xapRights:Marked> </rdf:Description>

     <rdf:Description rdf:about=''
      xmlns:dc='http://purl.org/dc/elements/1.1/'>
      <dc:rights>
       <rdf:Alt>
        <rdf:li xml:lang='x-default' >Copyright 2009, YOUR_NAME. Licensed to the public under Creative Commons LICENSE_NAME.</rdf:li>
       </rdf:Alt>
      </dc:rights>
     </rdf:Description>

     <rdf:Description rdf:about=''
      xmlns:cc='http://creativecommons.org/ns#'>
      <cc:license rdf:resource='LICENSE_URL'/>
     </rdf:Description>

    </rdf:RDF>
</x:xmpmeta><?xpacket end='r'?>
</pre></code>

== Step 2a (Mac OS X): Save the file to the right folder ==

Under OS X save the file to

<blockquote><tt>/Users/{YOUR USERNAME}/Library/Application Support/Adobe/XMP/Metadata Templates</tt></blockquote>

where {YOUR USERNAME} is replaced with your OS X short username. You may have to manually create the 'Metadata Templates' directory before saving.

The filename needs to end with '''.XMP'''.

== Step 2a (Windows): Save the file to the right folder ==

In Windows, the file should go in this folder:
<blockquote>
<tt>
C:\Documents and Settings\<em>{YOUR USERNAME}</em>\Application Data\Adobe\XMP\Metadata Templates
</tt>
</blockquote>

where {YOUR USERNAME} is replaced with your Windows username.  The easiest way do this is to save the file to the desktop, and then to:

# Click on the Start Menu
# Click "Run..."
# Type Desktop\..\Application Data
# Click "OK"
# Open the "Adobe" folder inside there
# Open the "XMP" folder inside there, ''or create it'' if there is no XMP folder
# Open the "Metadata Templates" folder inside, ''or create it'' if there is no folder by that name
# Drag the XMP file you saved to your desktop to the folder that just opened
# Close the folder

You may have to create the "XMP" folder under "Adobe", and you may also have to create the "Metadata Templates" folder under "XMP".

The filename needs to end with '''.XMP'''.

== Step 3: Mark Document ==

Within your Adobe application open the metadata panel while editing a file you want to mark (File|File Info in Photoshop).  Using the fly-out menu in the upper right corner of the panel, choose the template you saved.

http://www.creativecommons.org/images/metadata/xmp-adobe-panel.png

In Acrobat 6, go to Advanced | Document Metadata, select the Advanced panel on the left, then click on replace and select the xmp text file that you downloaded.

Creative Commons license information will appear in the Description panel.

== Step 4: Save and Publish ==

Save your file!  If publishing on the web the page that links to your XMP-marked document should contain a license notice and metadata, which can be copied from the same licensing process.

= Tagging multiple files at once =

You can mark multiple files with the same license metadata using the file browser (File|Browse in Photoshop).  Select the files you want to mark, then select the template you saved via the flyout menu in the metadata pane.

http://www.creativecommons.org/images/metadata/xmp-multiple.jpg

= Beyond single files: Creative Commons File Info Panel =

Copyright information is displayed in the standard Description panel (see screenshot above).  This may be supplemented by the [[Adobe Metadata Panel]].  This optional panel displays the copyright information available via the Description panel as well as a pointer to this page for help and a License URL, which may differ from the Copyright Info URL (see [[XMP#advanced|advanced usage]]).

http://www.creativecommons.org/images/metadata/xmp-cc-panel.png

<small><br>The XMP logo is either a registered trademark or trademark of the Adobe Systems Incorporated in the United States and/or other countries.