Add company and product documents via SFTP

You can upload a CSV file to map any products to documents found on publicly available URLs. Once the CSV is ingested, alby will scrape the data from it, adding it to its available information to provide to customers.

🚧

Be sure you have added alby’s IP addresses to your allow list, or alby may not be able to pull the information from your URLs.

This method allows for bulk uploads, ensuring your documentation is efficiently associated with the relevant products. The documents specified in the URLs will be automatically downloaded and linked to the corresponding products on the alby platform.

Example Filename

Brand_Documents_YYYYMMDD_HHMMSS.csv

Although the filename can be flexible, alby recommends starting it with the brand name and ending it with the export date. Any CSV file format is acceptable. Only alphanumeric characters and underscores are allowed; please avoid using special characters such as colons, spaces, etc. The name of the file must be alphanumeric with _ or - and must not contain spaces or special characters.

Prerequisites

Make sure you have setup a SFTP connection with alby. See setting up SFTP access.

After your connection with SFTP is successful, make sure you see a folder called documents_mapping, if it does not exist, create the folder with the exact naming. You must put the CSV file in this folder in order for document import to activate.

Specifications

  • Format
    • Files must be in a flat file CSV format. Excel XLSX files are not supported.
  • Encoding
    • All files must be UTF-8 compliant.
  • Header Row
    • Files must contain a header row that defines the columns.

CSV Format

The required CSV format for importing documentation consists of five columns, listed in the following order:

Column NameDescriptionRequired
filenameUnique name for the downloaded file.Yes
file_formatThe format of the file to be downloaded. Supported file formats include HTML, PDF, .TXT, DOCXYes
product_idsComma-separated list of Product IDs relevant to the file.Yes
external_urlFully qualified public URL (must start with https://) from which the file can be downloaded.Yes
file_typeSpecifies the type of document. Supported file types include: care,ingredients, instructions, product_snapshot, return_policy,sizing_guide, transcript, warranty.No

Examples of the supported file types are:

File typeExample
careHow to best take care of the product(s)
ingredientsDocument contains ingredients details, whether it's in list form, plain text or table
instructionsStep-by-step guidance on how to use the product effectively
product_snapshotBrief overview including key features, benefits, and specifications
return_policyDetails about return eligibility, timeframe, and process
sizing_guideDimensions, measurements, or size chart information
transcriptText version of any audio or video content related to the product
warrantyCoverage details, duration, and claim process information

Example CSV File

Below is an example of the required CSV format:

filenamefile_formatproduct_idsexternal_urlfile_type
A114533_ingredients.htmlHTMLA114533, A114534https://www.example.com/ingredients/A114533_ingredients.htmlingredients

Previous Articlealby Getting Started GuideNext Article
Importing your product data feed into albyCustomize alby's look and feel