The catalog page shows product information, prohibition rules, and prohibition reasons.
Uploading and updating product data
A product file is used to update product information on the VPP, which also updates GSA Advantage data.
Required fields
- CatalogKey
- Title
- ManufacturerName
- PartNumber
- SupplierCategoryId
- PrimaryCountry
- LongDescription
- UnitofIssue
- PackageQuantity
How to enter product and supplier authorization information
Our Getting started guide includes required templates you’ll use to upload your data. Users can also download blank upload templates in the VPP and click on the export tab.
File requirements
To import a catalog or supplier authorization information, the following file requirements apply:
- File must be saved as a CSV.
- File cannot contain more than two million product catalog records.
- File cannot contain more than one sheet in the workbook. Delete the description tab, if applicable.
- All headers must match the VPP headers.
- Required fields cannot be empty.
- Access API instructions.
VPP upload options
- Upload a product file (CSV format).
- Upload a product file (JSON format).
- Edit the product details page.
- Use an API connection.
How to import product catalog data
- Navigate to the catalog page to access the VPP dashboard and select the Catalog tab from the main portal navigation menu.
- Select the Import CSV file icon located in the upper right toolbar of the homepage to upload your file.

Invalid records
An invalid record contains missing or incorrectly formatted data in the required fields.
- Select the See Invalid Records Report in the Import summary to display any records that were not uploaded due to an error. If you have no issues, select OK.
- Select the Download button to review the report in CSV format. You may edit the records based on the error message(s) and re-upload.

What to do if you get an error message after uploading a product file
- Ensure the file is saved as a CSV in Excel before uploading.
- Review the data field requirements to ensure that all of the data is formatted correctly.
- Email vpp@gsa.gov if the issue persists and provide your user information, organization, and a description of the issue.
How to edit the product details VPP page
- Select the product to edit. Access the product record by selecting any field of the record.
- Select Edit button using the pencil icon located in the upper right toolbar next to the prohibition bar.
- Edit fields by using any of the product’s records fields.
- Save your edits by scrolling to the bottom of the screen and selecting the Save button. When saved correctly, a banner appears indicating the record is updated successfully.

Data upload and product change limits
You can upload up to two million records at once.
You can update one, multiple, or all of your products at the same time. Ensure you use the CatalogKey to update the appropriate record.
Navigating the product page
Filter product information by selecting Filter under one or more categories.
Navigate to Product Details by selecting the hyperlink of any field within the applicable row.
The Product Details page displays the following system, product, marketing, environmental, media, and marketing categories:
System information
| Category | Description |
|---|
| Catalog Key | Unique identification number or string to identify products within the catalog. The Catalog Key cannot be used more than once. |
| Organization | Name of the manufacturer. |
| Organization Type | Type of user role. |
| Last Update Date, Time | Date and time that the product info was most recently updated in the VPP. |
| Comment | Field for comments. |
| Global Shipment Identification Number, or GSIN, Mappings | Links to the affiliated GSA Advantage product pages. |
Main product information
| Category | Description |
|---|
| Brand | Name of the brand for the product. |
| Manufacturer Name | Name of the manufacturer. |
| Part Number | Part number for the product. |
| Title | Name of the product. Must contain at least three words, delimited by spaces. |
| Short Description | Short description of the product data sheet. |
| Long Description | Long description of the product or marketing text. Must contain at least ten words, delimited by spaces. |
Marketing and category information
| Category | Description |
|---|
| Global Trade Item Number, or GTIN | An umbrella term to describe varying types of GS1 numbering strings. The family of data structures — not symbologies — comprising GTIN include: - GTIN-12 (UPC-A): A 12-digit number used primarily in North America
- GTIN-8 (EAN/UCC-8): An 8-digit number used predominantly outside of North America
- GTIN-13 (EAN/UCC-13): A 13-digit number used predominantly outside of North America
- GTIN-14 (EAN/UCC-14 or ITF-14): A 14-digit number used to identify trade items at various packaging levels
|
| Northern American Industry Classification System, or NAICS | Self-assigned system used to classify business establishments for the purpose of collecting, analyzing, and publishing statistical data related to the U.S. business economy. Describes the primary and secondary income-producing lines of business. |
| Manufacturer Commercial and Government Entity, or CAGE, Code | Unique identifier assigned to suppliers to various government or defense agencies, as well as to government agencies themselves and also various organizations. CAGE codes provide a standardized method of identifying a given facility at a specific location. |
| Category | Broad product category name. |
| Family | Product family name. |
| Series | Product series name. |
| Model | Product model name. |
| Quality | Product quality indicator. For example, “remanufactured.” |
| Supply Category Name | Name of a Category ID. |
| Supply Category ID | An assigned ID to correspond with vendor authorizations. The supply category ID fields can all be set to 1 or a variety of numbers can be used to allow for a complex distribution chain — that is, specific vendors are permitted to carry specific products. |
| Unit of Issue | Standard quantity or packaging of a product that is used for ordering. |
| Package Quantity | Quantity of packages. |
| Primary Country | Primary country of origin for a product. Two letter country code utilizing ISO-2 format. |
| Secondary Country | Secondary country of origin for a product. Two letter country code utilizing ISO-2 format. |
| Tertiary Country | Tertiary country of origin for a product. Two letter country code utilizing ISO-2 format. |
| UNSPSC | The UNSPSC of the product. |
| Buy American Act | Contractor has certified that the product meets the manufacturing and domestic component test of the Buy American statute. |
Environmental information
| Category | Description indicates whether the product is |
|---|
| Remanufactured | Remanufactured. |
| Federal Energy Management Program, or FEMP | Follows the FEMP requirements |
| Safer Choice | Follows the Safer Choice program requirements. |
| Significant New Alternatives Policy, or SNAP | Follows the SNAP program requirements. |
| Comprehensive Procurement Guideline, or CPG | Follows the CPG program requirements. |
| United States Department of Agriculture, or USDA, BioPreferred | Follows the USDA BioPreferred requirements. |
| Electronic Product Environmental Assessment Tool, or EPEAT | Follows the EPEAT registry requirements. |
| Designed for Environment, or DfE | Follows the DfE certification requirements. |
| Single Use Plastics Free | Packaged free from single-use plastics. |
Media information
| Category | Description |
|---|
| Overview URL | Links to the PDF leaflet. Each link is separated by a vertical bar ( | ). |
| Manual URL | Links to the PDF leaflet. Each link is separated by a ‘’|’’. |
| Gallery Image URLs | Links to the PDF leaflet. Each link is separated by a ‘’|’’. |
| Gallery Resolutions | Resolutions of the product gallery images, separated by a ‘’|’’, if several. |
| Large Image URL | A link to the high-resolution image of the main product. |
| Large Image Resolution | The resolution of the main product image. |
| Medium Image URL | A link to the medium-resolution — 500 pixel — image. |
| Small Image URL | A link to the low-resolution product image. |
| Thumbnail URL | A link to the thumbnail image. |
| Video URLs | Links to product videos. Must be YouTube or MPEG-4. |
| View 360 URL | A link to a content type with a 360 degree — 3D — product view. |
| PDF Files URLs | Links to a PDF. A title is allowed for each link. |
| Other Multimedia | Other multimedia content types. |
| Datasheet URL | A link to a PDF or HTML data sheet. |
| Datasheet Updated | The date of the last change of the product data sheet. |
Marketing information
| Category | Description |
|---|
| Short Summary Description | A short editorial description of the product data sheet. |
| Long Summary Description | Marketing text. |
| Reasons to Buy | Reasons to buy, featuring bullet descriptions. |
| Stock Status | An inventory level. The only values allowed are: normal, limited, end-of-life, out-of-stock and discontinued. |
| Restock Date | A date when an out-of-stock item is expected back in stock. |
| Min Price Increase | A percent of an upcoming price increase (the lowest number offered to a distributor). |
| Price Increase Effective Date | A date of the upcoming price increase. |
| Authenticity Price Threshold | A price below which the authenticity of the item is questionable. |
| Reference Price | An estimate of the expected or average market price. |
| Energy Star Label | Indicates if the product is in the Energy Star program — 1 for YES or 0 for NO. |
| End of Life Date | The date the current product has or will reach its end of life. |
| Dynamic Specification | Product characteristics that otherwise don’t have a home, or that aren’t currently utilized at the field level within VPP. The dynamic nested structure allows you to list all of the products under a single header, or to separate these values under multiple headers. |