To access the SFTP ongoing, please enter the following information. Note - password is not required as the Label Insight SFTP site utilizes the SSH key authentication.
- Host: sftp.labelinsight.com
- Username: ____
- Port: 22
The following represents the basic Label Insight SFTP directory structure. Depending on your submissions and deliveries your actual structure may vary slightly. Please note if you select batching, scheduling, or zipping features your structure will appear differently.
deliveries > [delivery folder name]
Deliveries: for each delivery licensed from Label Insight, a new folder will be created within the “deliveries” folder. Most customers will only have 1 delivery, although it’s possible to have more than one. If additional folders are created for any reason your account manager will alert you.
In rare instances, the SFTP site may have a different structure. In these cases, our team works closely with you to ensure transparency & alignment. Please contact your account manager with questions.
Once the specific delivery folder is selected, there will be one JSON file per product unzipped.
Data flows in real-time from Label Insight’s system to the SFTP site. The following events will trigger an update to the product JSON file within your deliveries folder on the SFTP site.
Interested in receiving multiple products in a single JSON file? Let our team know you prefer batches.
Interested in receiving multiple JSON files zipped into 1 zip file? Let our team know you prefer zipping.
While the recommended integration is real-time, we also support scheduled pushes such as daily, weekly, monthly, and more. Let our team know if you have a preferred delivery schedule!
Pushes will occur on a product-by-product basis. Upon initial launch, we will push all applicable products to your destination
Any new product that falls within the licensing agreement will be sent as soon as it is available.
Any update to a licensed product reflected in your schema will result in a push
In the future, should additional data (such as attributes) be licensed, an update to the schema will occur and all impacted products will result in a new push.
The following steps must be completed prior to Label Insight setting up an SFTP delivery.
User Identification - For each user who will require access to the SFTP site provide:
- User Name - most often provided as a list of email addresses
- Public SSH Key - if you do not yet have SSH keys please see the section below.
SSH Key Generation - Label Insight’s SFTP utilizes SSH Key Authentication. If you already have SSH keys generated please skip this section. If you do not have SSH keys generated, please continue on and follow the instructions below for your operating system:
◦ Open Terminal
◦ Open cmd.exe
If you or your team are still unsure or experiencing difficulties, we’re happy to connect and help you self-generate SSH keys (recommended). Alternatively, Label Insight can generate SSH Keys for you, although it is a less secure path forward. For an overview on SSH Keys please read more information here.
Submission - Once steps “a” and “b” are complete, please provide an email to Label Insight with the list of designated usernames and associated the public SSH keys attached.
Public SSH keys can be identified by finding the file ending in .pub
If you have already added your SSH key file to your FTP software you may skip this step. If you have not added the key file, please note this is a one-time required initial step and you’ll need to follow the instructions below.
◦ Open FTP Software App, such as Filezilla
◦ Press Edit → Settings → Connection → FTP → SFTP
◦ Click “Add Key File” and Upload the SSH Key File
◦ Filezilla will Convert the Key
◦ Press “Ok”
If you or your team are still unsure or experiencing difficulties, we’re happy to connect and help you add your SSH key authentication. Please note if you utilize software other than Filezilla the instructions may vary slightly. Each FTP software provider will have SSH key instructions online.