RIS (file format)

RIS is a standardized tag format developed by Research Information Systems, Incorporated (the format name refers to the company) to enable citation programs to exchange data.^[1] It is supported by a number of reference managers. Many digital libraries, like Web of Science, IEEE Xplore, Scopus, the ACM Portal, Scopemed, ScienceDirect, SpringerLink, Rayyan, The Lens, Accordance Bible Software,^[2] and online library catalogs can export citations in this format. Citation management applications can export and import citations in this format.

RIS

Filename extension	.ris
Internet media type	application/x-research-info-systems
Type of format	Bibliography

Format

The RIS file format—two letters, two spaces and a hyphen—is a tagged format for expressing bibliographic citations. According to the specifications,^[3][4][5] the lines must end with the ASCII carriage return and line feed characters. Note that this is the convention on Microsoft Windows, while in other contemporary operating systems, particularly Unix, the end of line is typically marked by line feed only.

Multiple citation records can be present in a single RIS file. A record ends with an "end record" tag ER - with no additional blank lines between records.

Example record

This is an example of how the article "Claude E. Shannon. A mathematical theory of communication. Bell System Technical Journal, 27:379–423, July 1948" would be expressed in the RIS file format:

TY  - JOUR
AU  - Shannon, Claude E.
PY  - 1948
DA  - July
TI  - A Mathematical Theory of Communication
T2  - Bell System Technical Journal
SP  - 379
EP  - 423
VL  - 27
ER  - 

Example multi-record format

This is an example of how two citation records would be expressed in a single RIS file. Note the first record ends with ER - and the second record begins with TY - JOUR:

TY  - JOUR
AU  - Shannon, Claude E.
PY  - 1948
DA  - July
TI  - A Mathematical Theory of Communication
T2  - Bell System Technical Journal
SP  - 379
EP  - 423
VL  - 27
ER  - 
TY  - JOUR
T1  - On computable numbers, with an application to the Entscheidungsproblem
A1  - Turing, Alan Mathison
JO  - Proc. of London Mathematical Society
VL  - 47
IS  - 1
SP  - 230
EP  - 265
Y1  - 1937
ER  - 

Tags

The TY - tag must appear first and the ER - tag must appear last.^[6][7][8] Most tags must appear at most once, but the author, keyword, and URL tags can be repeated.^[6]

Each name must be formatted as a comma-separated list of last name, first name (including middle names, can be initials), and suffix, in that order, and must not be longer than 255 characters.^{[6][9][10][8]} Unless otherwise specified, each date must be formatted as a slash-separated list of 4-digit year, 2-digit month, 2-digit day, and other info (e.g. season); unused fields may be omitted if they are at the end.^[6][11][8]

Many strings have limits on what characters they can contain (e.g. any ASCII character, just alphanumerics, or just digits) or their length (often limited to 255 characters). These are only sometimes noted in the table below; see the linked sources to double-check, particularly ^[9] and the pages in RIS Format Specifications.

There are two major versions of the RIS specification, one from 2001, and one from the end of 2011 with different lists of tags for each type of record, sometimes with different meanings.^{[4][5][12][13]} Below is an excerpt of the main RIS tags, from both versions. Except for TY - and ER -, order of tags is free and their inclusion is optional.^{[better source needed]}

Tag	Meaning (see linked references for more details, such as which types have which interpretations)
A1	Interviewee.[14] (Primary) author.[9][10][15][16][17][18] Synonym of AU.[8]
A2	Secondary author/editor/translator, e.g. editor, performers, sponsor, series editor, reporter, institution, name of file, producer, series director, department, interviewer, issuing organization, recipient, or narrator. The tag must be repeated for each person. Synonym of ED.[6][9][10][14][8][15][16][18][19][20]
A3	Tertiary author/editor/translator, e.g. series editor/author, illustrator, editor, higher court, producer, director, international author, publisher, or advisor. The tag must be repeated for each person.[6][9][10][14][8][15][18][19][20] Collaborators.[16][17]
A4	Subsidiary/quaternary author/editor/translator, e.g. translator, counsel, sponsor, funding agency, performers, producer, department/division, or volume editor. The tag must be repeated for each person.[6][14][15][18][20]
A5	Quinary author / compiler.[15]
A6	Website editor.[15]
AB	Abstract or synopsis.[6][14][8][15][17][18][19] Notes.[11][20] Synonym of N2.[8]
AD	(Author/editor/inventor) address, e.g. postal address, email address, phone number, and/or fax number.[6][14][9][21][8][15][18][19] Institution.[20]
AN	Accession number.[6][14][15][20]
AU	(Primary) author/editor/translator, e.g. author, artist, created by, attribution, programmer, investigators, editor, director, interviewee, cartographer, composer, reporter, inventor, or institution. The tag must be repeated for each person. Synonym of A1.[6][10][14][8][16][17][18][19][20]
AV	Notes.[14] Availability (description of where to find it).[9][22][8][15] Location in archives.[citation needed]
BT	Primary/secondary title.[8][23][16][18][19] For Whole Book (BOOK) and Unpublished Work (UNPB) references, this maps to T1 or TI; for all other types, this maps to T2.[8][23] Subtitle.[16] Book title.[17]
C1	Custom 1, e.g. legal note, cast, author affiliation, section, place published, time period, term, year cited, government body, contact name, scale, format of music, column, or sender's e-mail.[6][14][18][20]
C2	Custom 2, e.g. PMCID, credits, year published, unit of observation, date cited, congress number, contact address, area, form of composition, issue, issue date, recipients e-mail, or report number.[6][14][18][20]
C3	Custom 3, e.g. size/length, title prefix, proceedings title, data type, PMCID, congress session, contact phone, size, music parts, or designated states.[6][14][18][20]
C4	Custom 4, e.g. reviewer, dataset(s), genre, contact fax, target audience, or attorney/agent.[6][14][18][20]
C5	Custom 5, e.g. format, packaging method, issue title, last update date, funding number, accompanying matter, format/length, references, or publisher.[6][14][18][20]
C6	Custom 6, e.g. NIHMSID, CFDA number, legal status, issue, or volume.[6][14][18][20]
C7	Custom 7, e.g. article number or PMCID.[6][14][18][20]
C8	Custom 8, not used by any of the standard types.[6][14][18][20]
CA	Caption.[6][14][18][19][20]
CL	Classification.[15]
CN	Call number.[6][14][15][16][18][19][20]
CP	City/place of publication.[9][16] Issue.[21][18]
CR	Cited references.[15]
CT	Caption.[14] Primary title.[23][16] Address.[18] Title of unpublished reference.[citation needed]
CY	Place published, e.g. city, conference location, country, or activity location.[6][14][21][8][16][18][19][20]
DA	Date, e.g. date accessed, last update date, date decided, date of collection, date released, deadline, date of code edition, or date enacted.[6][14][18][20]
DB	Name of database.[6][14][15][18][20]
DI	Digital Object Identifier (DOI).[18]
DO	Digital Object Identifier (DOI).[6][14][15][16][18][19][20] This used to be documented as "Document Object Index".[24]
DOI	Digital Object Identifier (DOI).[17]
DP	Database provider.[6][14][18][20]
DS	Data source.[15]
ED	Secondary author.[10] Editor.[17][18][19] Synonym of A2.[8][16] Edition.[15]
EP	Pages.[14] End page.[9][21][8][16][17][18][19]
ER	End of reference. Must be the last tag.[6][7][9][23][8][17]
ET	Edition, e.g. epub (electronic publication?) date, date published, session, action of higher court, version, requirement, description of material, international patent classification, or description.[6][14][16][18][19][20]
FD	Free-form publication data.[15]
H1	Location (library).[16]
H2	Location (call number).[16]
ID	Reference identifier, may be limited to 20 alphanumeric characters.[9][23][8][15][18][19]
IP	Identifying phrase.[15]
IS	Number, e.g. issue or number of volumes.[6][14][9][21][8][15][16][17][18][19][20]
J1	Notes.[14] User abbreviation 1 of journal/periodical name.[9][25][8][13][18]
J2	Alternate title, e.g. alternate journal, abbreviated publication, abbreviation, or alternate magazine. If possible, it should be a standard abbreviation, preferably using the Index Medicus style including periods. This field is used for the abbreviated title of a book or journal name, the latter mapped to T2.[6][14][13][18][20] User abbreviation 2 of journal/periodical name.[9][25][8][13]
JA	Standard abbreviation for journal/periodical name.[25][13][16][17][18]
JF	Full name of journal/periodical.[9][25][8][13][15][16][17][18][20]
JO	Abbreviation (for journal/periodical name).[14][8][13][15][16][17][18][19] "Periodical name: full format. This is an alphanumeric field of up to 255 characters."[9][25]
K1	Keyword.[15]
KW	Keyword/phrase. Must be at most 255 characters long. May be repeated any number of times to add multiple keywords.[6][14][9][26][8][16][17][18][19][20]
L1	File attachments, e.g. figure.[6][14][18][19][20] "Link to PDF. There is no practical length limit to this field. URL addresses can be entered individually, one per tag or multiple addresses can be entered on one line using a semi-colon as a separator. These links should end with a file name, and not simply a landing page. Use the UR tag for URL links."[9][22] Internet link.[16] Local file.[18]
L2	URL.[14] "Link to Full-text. There is no practical length limit to this field. URL addresses can be entered individually, one per tag or multiple addresses can be entered on one line using a semi-colon as a separator."[9][22] Internet link.[16]
L3	DOI.[14] Related records.[9][22] Internet link.[16]
L4	Figure, e.g. URL or file attachments.[6][14][18][19][20] Images.[9][22] Internet link.[16] Local file.[18]
LA	Language.[6][14][15][18][19][20]
LB	Label.[6][14][18][20]
LK	Links.[15]
LL	Sponsoring library location.[15]
M1	Number, publication number, text number, size, bill number, series volume, computer, issue, chapter, status, document number, start page, issue number, folio number, number of screens, application number, number of pages, public law number, or access date.[14][18][20] Miscellaneous 1.[9][22][8][17][18] A good place for type or genre information.[8]
M2	Start page, notes, or number of pages.[14][20] Miscellaneous 2.[9][22][17][18]
M3	Type of work, e.g. type (of work/article/medium/image); citation of reversal; medium; funding, patent, or thesis type; format; or form of item.[6][14][18][20] Miscellaneous 3.[9][22][8][17][18] Suitable to hold the medium.[8]
N1	Notes.[6][14][9][11][8][16][17][18][19][20]
N2	Abstract.[14][9][11][8][16][18] Synonym of AB.[8]
NO	Notes.[15]
NV	Number of volumes, e.g. extent of work, reporter abbreviation, catalog number, study number, document number, version, amount received, session number, frequency, manuscript number, US patent classification, communication number, series volume, or statute number. Ignored for Press Release (PRESS).[6][14][18][19][20]
OL	Output language (using one of the documented numeric codes).[15]
OP	Original publication, e.g. contents, history, content, version history, original grant number, or priority numbers.[6][14][18] Other pages.[15][20] Original foreign title.[15]
PA	Personal notes.[15]
PB	Publisher, e.g. court, distributor, sponsoring agency, library/archive, assignee, institution, source, or university / degree grantor.[6][14][9][21][8][15][16][17][18][19][20]
PMCID	PMCID.[15]
PMID	PMID.[15]
PP	Place of publication.[15]
PY	(Primary) (publication) year/date, e.g. year decided, year of conference, or year released.[6][14][11][8][16][17][18][20] Must always use 4 digits, with leading zeros if before 1000.[6] Synonym of Y1.[8]
RD	Retrieved date.[15]
RI	Reviewed item, geographic coverage, or article number.[14][18][20]
RN	Research notes.[14][18][20]
RP	Reprint status, e.g. reprint edition, review date, or notes. Has three possible values: "IN FILE", "NOT IN FILE", or "ON REQUEST". "ON REQUEST" must be followed by an MM/DD/YY date in parentheses.[6][14][9][26][8][17][18][20]
RT	Reference type.[15]
SE	Section, screens, code section, message number, pages, chapter, filed date, number of pages, original release date, version, e-pub date, duration of grant, section number, start page, international patent number, or running time.[14][18][20]
SF	Subfile/database.[15]
SL	Sponsoring library.[15]
SN	ISSN, ISBN, or report/document/patent number.[14][9][21][8][15][16][17][18][19][20]
SP	Pages, description, code pages, number of pages, first/start page, or running time.[14][9][21][8][15][16][17][18][19][20]
SR	Source type: Print(0) or Electronic(1).[15]
ST	Short title or abbreviated case name.[14][15][18][20]
SV	Series volume.[14]
T1	(Primary) title.[14][9][23][13][15][16][17][18]
T2	Secondary title, journal, periodical, publication title, code, title of weblog, series title, book title, image source program, conference name, dictionary title, periodical title, encyclopedia title, committee, program, title number, magazine, collection title, album title, newspaper, published source, title of show, section title, academic department, or full journal name.[6][14][9][23][8][13][15][16][18][19][20] Subtitle.[16]
T3	Tertiary title, volume title, series title, legislative body, institution, decision, website title, location of work, supplement no., international title, paper number, international source, or department.[14][9][23][8][15][16][18][19][20]
TA	Translated author.[14][20]
TI	(Primary) title, e.g. title of entry/grant/podcast/work, case name, or name of act.[14][23][8][13][16][17][18][19][20]
TT	Translated title.[14][18][20]
TY	Type of reference. Must be the first tag.[6][7][9][23][8][17][20]
U1	Notes.[14][18] User definable 1.[9][22][8][15][16][17] Thesis-type hint.[27][19]
U2–U5	Notes.[14][18] User definable 2–5.[9][22][8][15][16][17]
U6–U15	User definable 6–15.[15]
UR	Web/URL. Can be repeated for multiple tags, or multiple URLs can be entered in the same tag as a semicolon-separated list.[6][9][22][8][15][16][17][18][19][20]
VL	Volume, code volume, access year, reporter volume, image size, edition, amount requested, rule number, volume/storage container, number, patent version number, code number, or degree.[14][9][21][8][16][17][18][19][20]
VO	Volume.[15][18] Published Standard number.[citation needed]
WP	Date of electronic publication.[15]
WT	Website title.[15]
WV	Website version.[15]
Y1	"Year///Date".[14] Primary date/year.[9][11][16][17][18] Synonym of PY.[8]
Y2	Access date or date enacted.[14][18][20] Secondary date.[9][11][8][16] Date of publication.[17]
YR	Publication year.[15]

Type of reference

The type of reference preceded by the TY - tag must abbreviated as:

RIS reference types

Abbreviation ("Field Label")	Type ("Ref Type")	Category[14]
ABST	Abstract[6][9][28][8][16][18][19]	Journal Article
ADVS	Audiovisual (material)[6][14][9][28][8][16]	Audiovisual Material
AGGR	Aggregated database[6][14]	Aggregated Database
ANCIENT	Ancient text[6][14]	Ancient Text
ART	Artwork[6][14][9][28][8][16]	Artwork
BILL	Bill/resolution[6][14][9][28][8][16]	Bill (was Bill, Unenacted Bill)
BLOG	Blog[6][14]	Blog
BOOK	Book (whole)[6][14][9][28][8][16][18][19]	Book
CASE	Legal case and case notes[6][14][9][28][8][16][18][19]	Case
CHAP	Book section/chapter[6][14][9][28][8][16][18]	Book Section
CHART	Chart[6][14]	Chart
CLSWK	Classical work[6][14]	Classical Work
COMP	Computer program[6][14][9][28][8][16][18][19]	Computer Program
CONF	Conference proceedings[6][14][9][28][8][16][18]	Conference Proceedings
CPAPER	Conference paper[6][14]	Conference Paper
CTLG	Catalog[6][14][9][28][8][16]	Catalog
DATA	Data file / dataset[6][14][9][28][8][16]	Dataset (was Data File) AND Computer Program
DBASE	Online database[6][14]	Online Database
DICT	Dictionary[6][14]	Dictionary
EBOOK	Electronic book[6][14]	Electronic Book
ECHAP	Electronic book section[6][14]	Electronic Book Section
EDBOOK	Edited book[6][14]	Edited Book
EJOUR	Electronic article[6][14]	Electronic Article
ELEC	Web page / electronic citation[14][9][28][8][16][18][19]	Web Page
ENCYC	Encyclopedia[6][14]	Encyclopedia
EQUA	Equation[6][14]	Equation
FIGURE	Figure[6][14]	Figure
GEN	Generic[6][14][9][28][8][16][18]	Generic
GOVDOC	Government document[6][14]	Government Document
GRNT	Grant[6][14]	Grant
HEAR	Hearing[6][14][9][28][8][16][18][19]	Hearing
ICOMM	Internet communication[6][9][28][8][16]	Personal Communication
INPR	In press article[6][9][28][8][16]	Journal Article
INTV	Interview[6][14]	Interview
JFULL	Journal/periodical (full)[6][9][28][8][16]	Journal Article
JOUR	Journal/periodical (article)[6][14][9][28][8][16][18][19]	Journal Article
LEGAL	Legal rule (or regulation)[6][14]	Legal Rule
MANSCPT	Manuscript[6][14]	Manuscript
MAP	Map or cartographic data[6][14][9][28][8][16][18][19]	Map
MGZN	Magazine (article)[6][14][9][28][8][16][18][19]	Magazine Article
MPCT	Film or broadcast / motion picture[6][14][9][28][8][16]	Film or Broadcast
MULTI	Online multimedia[6][14]	Online Multimedia
MUSIC	Music (score)[6][14][9][28][8][16]	Music
NEWS	Newspaper (article)[6][14][9][28][8][16][18][19]	Newspaper Article
PAMP	Pamphlet[6][14][9][28][8][16][18][19]	Pamphlet
PAT	Patent[6][14][9][28][8][16][18][19]	Patent
PCOMM	Personal communication[6][14][9][28][8][16][18][19]	Personal Communication
POD	Podcast[6][14]	Podcast
PRESS	Press release[6][14]	Press Release
RPRT	Report[6][14][9][28][8][16][18][19]	Report
SER	Serial (book, monograph)[6][14][9][28][8][16]	Serial
SLIDE	Slide[6][9][28][8][16]	Audiovisual Material
SOUND	Sound recording[6][9][28][8][16]	Audiovisual Material
STAND	Standard[6][14]	Standard
STAT	Statute[6][14][9][28][8][16][18][19]	Statute
STD	Generic[18]
THES	Thesis/dissertation[6][14][9][28][8][16][18][19]	Thesis
UNBILL	Unenacted bill/resolution[6][9][28][8][16]	Bill (was Bill, Unenacted Bill)
UNPB	Unpublished work[14][9][28][8][16][18][19]	Unpublished Work
UNPD	Unpublished work[6]
VIDEO	Video recording[6][9][28][8][16]	Audiovisual Material
WEB	Web page[6]

See also

• BIBFRAME—bibliographic framework, an emerging standard to replace MARC
• Bibliographic record—general concept
• BibTeX—a text-based data format used by LaTeX
• EndNote—a text-based data scheme used by the EndNote program
• MARC—machine-readable cataloging standards
• refer—an aging text-based data scheme supported on UNIX-like systems