# SharinPix Imports Requirements

This article outlines the requirements for the following SharinPix operations:

* [Image import](#image-import)
* [Tag migration](#tag-migration)
* [Tag bulk deletion](#tag-bulk-deletion)

## Required Import Information

Mass image imports and tag migrations are recommended to be performed by the SharinPix team.

For such imports, kindly contact the SharinPix support team first at [**support@sharinpix.com**](mailto:support@sharinpix.com) with:

1. A description of the import you want to achieve.
2. The number of records/ images/tags included.
3. The average image size, if applicable.

Once the import is validated by our team, you will need to provide the following additional information:

* Your organization ID.
* A CSV file including all your import data. Please refer to the [Image Import](#image-import), [Tag Migration](#tag-migration), [Tag Bulk](#tag-bulk-deletion) Deletion sections for more information on the CSV file format in each case.
* Your organization's API limit.
* Kindly also state if [tag action](/documentation/features/working-with-tags/tag-action.md) or [image sync](/documentation/image-sync/setup-sharinpix-image-sync.md) should be launched after the import.

{% hint style="warning" %}
**Note:**

For small-volume imports, the SharinPix package already includes Apex methods you can easily run on your end. Some of these methods are:

* **uploadAttachment**: Uploads Salesforce attachments to SharinPix albums.
* **uploadContentDocument**: Uploads Salesforce ContentDocuments to SharinPix albums.
* **uploadFromUrl**: Uploads an image to SharinPix using a URL.

For more information on how to call the above methods and other SharinPix import Apex methods, please refer to the following article: [Utils methods](/documentation/cookbook/utils-methods.md).

⚠️ Large import volumes can trigger internal safety limits, resulting in a temporary block for your organization. Please follow our volume guidelines to ensure uninterrupted service.
{% endhint %}

## Image Import

### Image Import from Storage to SharinPix

For image imports from your storage (for example, Amazon S3) to SharinPix, the CSV file should include the following columns:

* **album\_id**: The *album\_id* column should contain the 18-digit record ID on which you want the image to be uploaded.
* **url**: The *url* column should contain the public image URLs as they appear in your storage.
* **tags**: The *tags* column should contain the tag or tags to be applied to each image. If two or more tags should be applied, please ensure that all tags are added in a single cell and separated by commas as follows: <mark style="color:$danger;">`tag1,tag2,tag3`</mark>

### Image Import from Salesforce Content Document to SharinPix

For image imports from Salesforce files to SharinPix, the CSV file should include the following columns:

* **album\_id**: The *album\_id* column should contain the 18-digit record IDs on which you want the image to be uploaded.
* **content\_document\_id**: The *content\_document\_id* column should contain the 18-digit Content Document record IDs
* **tags**: The *tags* column should contain the tag or tags to be applied to each image. If two or more tags should be applied, please ensure that all tags are added in a single cell and separated by commas as follows: <mark style="color:$danger;">`tag1,tag2,tag3`</mark>

## Tag Migration

For tag migrations from one organization to another, the CSV file should include the following columns:

* **Id**: Should contain the IDs of the tags to be migrated.
* **Name**: Should contain the tags' technical name.
* **Label**: Should contain the tags' labels.
* **Listed**: Should indicate whether the tags should be available for use in your organization.\
  \&#xNAN;*Note*: This column can only contain true or false (boolean).
* **Visible**: Should indicate whether the tags should be visible to everyone in your organization.\
  \&#xNAN;*Note*: This column can only contain true or false (boolean).
* **Color**: Should contain the tags' label color in Hex format.
* **Public**: Should indicate whether the tag should be public (shared externally). This is only used for tags used to share images externally. It is excluded in most cases.\
  \&#xNAN;*Note:* *This column can only contain true or false (boolean).*
* **Allow download**: Should indicate whether file downloading is permitted when the tag is public.\
  \&#xNAN;*Note:* *This column can only contain true or false (boolean).*

{% hint style="success" %}
**Tip:**

On the [Tags](https://app.sharinpix.com/admin/tags) page of the admin dashboard, a CSV download option is available at the bottom of the page that contains all the tags in your organization, with all the required columns for tag migrations.
{% endhint %}

## Tag Bulk Deletion

For tag bulk deletions, only **Id** column is required, containing the IDs of all tags to be deleted.

{% hint style="success" %}
**Tip:**

Tag IDs can be retrieved by viewing tags from the [Tags page](https://app.sharinpix.com/admin/tags) on the admin dashboard. A CSV download option is available at the bottom of the page that contains all the tags in your organization.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.sharinpix.com/documentation/access-and-security/sharinpix-imports-requirements.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.