Free Customized Converter for Your Site
XE.com offers two levels of customization that enable webmasters to seamlessly integrate our XE Currency Converter — the world's most popular Internet currency tool — into your site. Regardless of which you choose, both options give you:
- Live rates updated non-stop all day, every day
- Access to every world currency in existence
- Unlimited usage with no "hidden fees"
- Unlimited free changes and updates to your converter
- Support for a growing list of foreign languages
- Peace of mind — our currency services have been in continuous operation since 1995!
- QUICK JUMP MENU
- Free Customization: What You Get
- Important Notes about the Customization Process
- Fast-Track Instructions for Customizing the Converter
- OPTIONAL: Advanced Instructions for Customizing the Converter
|Option:||1. Free Customization||2. Full Customization|
|XE.com Ads:||Yes: 1 (one) banner ad||No: 0 (zero) banner ads|
|Input Page:||Customized as you desire and hosted on your site.||Customized as you desire and hosted on your site.|
|Results Page:||Our standard currency converter results, including 1 (one) XE.com banner ad, but encapsulated in HTML code specified by you.||Converter results, without any XE.com banner ad, customized to your specifications. You may include any number of your own ads.|
|Currencies Available:||As few or many as you want, up to all 189 world currencies||As few or many as you want, up to all 189 world currencies|
|Cost:||100% free.||A flat annual rate of US$540. Unlimited usage. The world's most popular currency converter. No hidden charges, all taxes included. What more can we say?|
|For more info:||Keep reading this document.||Click here to go to the full customization page.|
This document describes how to put a customized version of the XE Currency Converter, like the one pictured above, on your site. After reading through the legal information below, the process itself takes less than five minutes.
By choosing XE.com as your currency partner, you are choosing the Internet's largest provider of foreign exchange tools and services. Independent industry rankings consistently confirm that more people — and websites — use our wide variety of simple and powerful currency tools than any others.
WARNING: Read these restrictions carefully! Use of the converter that does not conform to these restrictions is not permitted. Regretfully, misuse of our services has forced us to be more aggressive in pursuing legal action against violators of our internationally protected intellectual property rights. Our main goal is to keep the services running, which we need your help to do. Please conform to our requirements when customizing the service.
We can and we do track the location of external input pages to ensure that they comply with the legal requirements. We freely encourage the use of our converter, but we must protect our copyright and trademark rights.
- Your resource may not give the impression that any entity other than XE.com is responsible for the functionality of the resource. You may take credit for the design of your interface, but not for the functionality provided by our services.
- You may, if you wish, simplify your input page or result page by reducing the number of available currencies. You may further simplify your input page by "hard coding" values and settings into hidden variables in your input page form.
- You are not required to provide a link to the Converter master site;
however, if you do so, it must be done in the following format:
<A HREF="http://www.xe.com/">The XE Currency Converter Services</A>
- If you desire, you are permitted to incorporate our
logo into your interface by directly referencing it at our site, but not by copying it to yours. However, if you do so, it must be
done in the following format:
<A HREF="http://www.xe.com/"><IMG SRC="http://www.xe.com/gen/illegal2copy.gif" WIDTH=45 HEIGHT=45 BORDER=0 ALT="UCC"></A>If you like, you can use our alternate graphic, which has a white background, by using the following HTML:<A HREF="http://www.xe.com/"><IMG SRC="http://www.xe.com/gen/illegal2copy-w.gif" WIDTH=45 HEIGHT=45 BORDER=0 ALT="UCC"></A>WARNING: No other use of the XE logo is permitted. It is copyrighted intellectual property and a trade mark of XE.com. You are not permitted to duplicate it, distribute it, or alter it in any way. To protect our rights and identity, we must aggressively pursue legal action against violators of our internationally protected intellectual property rights.
- If you use the phrase "XE Currency Converter" in your interface, and if the phrase is not part of a hyperlink to the master Converter site, then you must attach a trade mark symbol hyperlink to each instance in the following format:
- You agree to hold XE.com harmless from any action brought against you by a third party as the result of the contents of your Web pages, including a Converter input page adhering to these restrictions. You acknowledge that XE.com is not — and can not be — responsible for content that you deploy on your site.
- You agree to use your best efforts to ensure that your input page interfaces with the converter pursuant to specified methods, that your interface works, and that appropriate upgrades and additions to the Converter are reflected in your page. Specifically, but not exclusively, you agree to add or remove currencies as instructed by XE.com personnel as our currency feed changes and grows.
- You understand, acknowledge, and agree to the following:
XE.com is not a financial institution, not affiliated with any financial institution, and not a rate feed provider. We do not distribute currency rates for a fee. Our rates are derived from a variety of publicly available sources, and we reserve the right to change our sources at any time without notice. Although we strive to ensure our figures are correct, we can make no guarantees as to their accuracy or suitability for any purpose. While effort is taken to ensure their accuracy, errors can from time to time appear. Currency rates specified by financial institutions will differ from ours, sometimes significantly. In addition, currency rates will vary by geographical market. The end user assumes all risk for the use of any information provided by our services.
- You understand and acknowledge that XE.com cannot support a free service whose primary components are off of our server and outside of our control. This customization process is currently used by thousands of sites, so any problems you experience are at your end. Again, we regret that we cannot support your development efforts. If you need assistance, do not contact our staff.
- You acknowledge that you have read and that you understand the legal information pertaining to these services located at:
- You complete the following form in its entirety. All sections must be completed. In addition, you must fully complete one for each
customized interface that you create. You MUST fill out this form. It should take less than two minutes of your time. Besides being a requirement
for customization, it will help us keep you up to date with important additions and enhancements to the converter, such as the addition of new
And now, the good news. As a reward for wading through all that legalese above — believe me, we don't like it any more than you do — you now get to "fast track" the customization of the converter.
By popular demand, we have simplified the process of customizing the converter. We have prepared a standardized block of HTML code that you can simply drop into any of your pages. No HTML coding is necessary! Just follow the simple steps below.
Download the quick-start HTML code.
Right-click on this link and choose "Save target as" to download the file to your hard drive. Left-Click the link above to see what it looks like in your browser.
Insert the quick-start HTML code into your page.
Cut and paste the contents of samp-ucc.htm into your Web page.
Upload the page to your Website.
Update your Website with the new page using your normal update method.
That's all there is to it! You will now have a fully-functional version of the converter in your Web page.
Most Webmasters stop here. However, advanced Webmasters may want to take advantage of some of the other features possible through customization. If you are one, then read on!
Proceed at your own risk! Although these instructions should be pretty straightforward to people familiar with HTML and forms, we cannot possibly support a free service whose primary components are off of our server and outside of our control. In short, if you need assistance, please do not contact our staff. This customization process has been tested and works perfectly, so any problems you experience are at your end. Again, we regret that we cannot support your development efforts.
Changing The Appearance of your Input Page
Changing the Order of Currencies in your Lists
You are free to reorder the currencies in the lists on your converter. However, you must move entire currency lines, including the <OPTION> and </OPTION> tags.
Preselecting Variables in Your Converter
You may want to set different default value for your converter. This is very easy to do.
Presetting the "Amount" field: Just change the number in the VALUE="" portion of the INPUT tag. For example, to start with a default value of 50 currency units, your "Amount" input tag would look like this (the green text indicates where you preset the desired amount):<INPUT TYPE="text" NAME="Amount" VALUE="50" SIZE=10>Presetting the "To" or "From" currency field: Just move the word SELECTED to the currency of your choice. (Hint: It helps if this currency is near enough to the top of the list to be displayed in the selection window; otherwise, the user might not be aware that a selection has been preset.) The resulting preselected currency will look like this:<OPTION SELECTED>CHF Switzerland Francs</OPTION>Currencies that are not preselected (i.e. all the others in the list) will look like this:<OPTION>NLG Netherlands Guilders</OPTION>
Hard-Coding Variables in Your ConverterSometimes it's not enough to preselect a currency: sometimes you want to give the user no choice in the matter and force the use of a certain currency. This is done by removing the selection areas and replacing them with hidden variables. Remember, for each variable that you "hard code" with a hidden variable, you must remove the corresponding input section.<FORM METHOD=POST ACTION="http://www.xe.com/currencyconverter/convert.cgi">Now, here are some examples of how to create "hard coded" hidden variables:
Hard coding the "Amount" variable: Here is an example of how to hard code the "Amount" variable to be exactly 100.00:<INPUT TYPE="HIDDEN" NAME="Amount" VALUE="100.00">Hard coding the "From" currency variable: Here is an example of how to hard code the "From" variable to be U.S. Dollars (USD):<INPUT TYPE="HIDDEN" NAME="From" VALUE="USD">Hard coding the "To" currency variable: Here is an example of how to hard code the "To" variable to be Euro (EUR):<INPUT TYPE="HIDDEN" NAME="To" VALUE="EUR">
Adding Currencies to Your Converter
Your version of the service is not limited to the "default" set of currencies that we provide. You are free to add as many other currencies as you wish. (Our services do support every world currency unit!) You can obtain extra desired currencies by "cutting and pasting" from the "Full" XE Currency Converter.
For example, let's say you wanted to add the Guatemala Quetzal to your converter, in your "From" currency list. All you would have to do is add the following line in the desired spot between the <SELECT NAME="From"> tag, and the corresponding </SELECT> tag:
Removing Currencies from Your Converter
Just as you are free to add currencies to your converter, you are free to remove currencies from either the "To" and "From" fields of your converter. More often than not, this is actually a very good thing to do.
Why would you want to remove currencies? As we have already mentioned, 85% of the people using our services are served by the top 10 currencies alone! Every currency you add to this list increases the time it takes for a user to find their currency. You should try to tailor the currencies you support to the actual needs of your users. While "listing them all" may seem like a good idea, your users may not agree.
In fact, there are circumstances where you might want to remove all currencies except for one, as outlined below.
Setting the Time Zone of Your Converter
By default, your converter will display date and time information in Universal Coordinated Time ("UTC"), also known as Greenwich Mean Time ("GMT"); or Zulu Time ("Zulu"). All of the these refer to the same thing: the time of day at the "prime meridian", which is 0° longitude. UTC is widely used as a reference timezone.
However, if you suspect that your converter will be used primarily by people in a specific time zone, then you can set the converter to display any date and time information in that timezone. This is done by passing a hidden variable to the converter. For example, let's say you lived in Toronto, Canada and wanted to set the timezone for your converter appropriately. You would include the following code in you FORM:<INPUT TYPE="HIDDEN" NAME="timezone" VALUE="EST5EDT">
Both the variable name "timezone" and the timezone value itself are case-sensitive. "EST5EDT" is the time zone for New York City and much of the eastern United States. For other locations, replace this code with the appropriate timezone. The following is a list of time zone codes than can be passed to the converter. Codes with both "ST" and "DT" suffixes, such as the "EST5EDT" in the above example, will automatically respect daylight savings time in your area.
While we cannot support development of free customizations, we can provide modifications to the standard service for a fee. For more information, please see our Full Customization page.