U.S. flag

An official website of the United States government

Video tutorial: Add a data resource to your dataset on the Ag Data Commons

Fields marked with an asterisk are required. All other fields are optional. If N/A, leave the field blank.

  • File Name​*​: Enter a descriptive resource title as you want it to appear; if uploading multiple resources, include information that distinguishes this one from the others you will provide. It is particularly helpful to include the format of the resource in the title and it is not necessary to repeat details that are in the title of the dataset.

    • Helpful information to add to a file name includes project or experiment name or acronym, location/spatial coordinates, researcher name/initials, date or date range of experiment, type of data, conditions, version number of file
    • Avoid confusing labels such as “revision”, “final”, “final 2”, etc. in the file name
  • Option to Link to a file, Link to an API, or Upload a File​:

    • Upload a file: ​If you are uploading a file, multiple files can be dragged into the interface window at once. Or, select “+ Add Files” in the lower left corner of the dialog box. Remember to select “Start upload.”

      • If your file is in csv or text format, select the delimiter used, if applicable.

      • Please note, the Ag Data Commons does not accept executable files of any type.

    • Link to a file: ​Enter a link to one of the following file formats: csv, html, xls, json, xlsx, doc, docx, rdf, txt, jpg, png, gif, tiff, pdf, odf, ods, odt, tsv, geojson, or xml.

    • Link to an API: ​Link to an API if you want to link to a web page.

  • File Format​: Specify format of the resource (e.g. CSV, HTML, XML, etc.). All resources linked to from an API should be designated as HTML regardless of the type of resource found at that link.

  • Description​: Provide a detailed description of your resource. For example, if it is an Excel file with multiple tables, describe what the different tables contain. Imagine that you are a novice user: what information would you need to make sense of this resource?

  • Text Format​: This refers to the text format of the description block. Although it should not be necessary, you can change the format to suit your preference.

  • “Make this resource the data dictionary” checkbox​: Check this if the resource you are uploading is the data dictionary. See the sections regarding data dictionaries in this document for more information on data dictionaries.

  • Recommended Software:​ Provide a name, version number, and stable URL for software tools recommended to view or run this resource.

  • Dataset:​ This field will auto-populate with the title of the dataset associated with this resource. Do not edit or add to this field.

  • Weight​: This field determines the order in which the resources will be displayed on the dataset page. The lowest value will be displayed first.

  • Described by​: This field is restricted to ADC curators. Submitters should leave this field blank.

  • URL Path Settings​: A URL will automatically be generated for this metadata record unless you uncheck the “Generate automatic URL alias” box; once it’s unchecked, you may enter a customized URL if you wish.

  • Revision Information​: If this is a revision to a previously uploaded file, check the box and provide an explanation as to why you are revising the submission.

  • Scheduling Options​: If you would like to place an embargo on the publication of your resource, enter the date you would like it to be published here. Format is YYYY-MM-DD. You may enter a date up to three years in the future. If you would like your data resource to be published immediately upon curator approval, with no embargo, leave this field blank.