# Reference

The references of one or more documents to display references for. You can return the values of all reference fields in the given documents (for example, to find the value of another reference field from a value that you know).

If the reference contains plus symbols (`+`) or spaces, you must percent-encode the reference twice. If you have multiple references, percent-encode each reference separately once, then separate the references with plus symbols (there must be no space before or after a plus symbol) and percent-encode the whole string again (using a Web browser or the ACI client).

Reference encoding example.

If you have the following two references:

- http://www.example.com/?script.pl&query=test

- http://www.example.com/?script.pl&query=cat+dog

Percent-encode each reference:

    http%3A%2F%2Fwww%2Eexample%2Ecom%2F%3Fscript%2Epl%26query%3Dtest

    http%3A%2F%2Fwww%2Eexample%2Ecom%2F%3Fscript%2Epl%26query%3Dcat%2Bdog

Separate the two references with a plus symbol:

    http%3A%2F%2Fwww%2Eexample%2Ecom%2F%3Fscript%2Epl%26query%3Dtest+http%3A%2F%2Fwww%2Eexample%2Ecom%2F%3Fscript%2Epl%26query%3Dcat%2Bdog

Percent-encode the whole string again:

    http%253A%252F%252Fwww%252Eexample%252Ecom%252F%253Fscript%252Epl%2526query%253Dtest%2Bhttp%253A%252F%252Fwww%252Eexample%252Ecom%252F%253Fscript%252Epl%2526query%253Dcat%252Bdog

You can return only the values of a particular reference field by specifying the ReferenceField parameter.

Actions: | GetAllRefs
Type: | String
Default: |
Example: |
    Reference=http%253A%252F%252Fwww%252Eexample%252Ecom%252F%253Fscript%252Epl%2526query%253Dtest%2Bhttp%253A%252F%252Fwww%252Eexample%252Ecom%252F%253Fscript%252Epl%2526query%253Dcat%252Bdog
In this example documents that have the reference `http://www.example.com/?script.pl&query=test` and `http://www.example.com/?script.pl&query=cat+dog` are returned.
See Also: | ReferenceField

_FT_HTML5_bannerTitle.htm