# Importer des joueurs par lots (CSV) (/docs/joueurs/importer-joueurs-csv)



## Vue d'ensemble [#vue-densemble]

Pour créer un effectif complet, inutile de saisir les joueurs un par un : la page **Mes sportifs** propose un **import par lots** depuis un fichier **CSV**. L'import se fait en deux temps — une **prévisualisation** complète (rien n'est écrit), puis la **confirmation**.

Le bouton se trouve à côté de « Créer un sportif » (menu du bouton, option **Importer par lots**).

<VideoAVenir titre="Importer des joueurs par lots" />

## Le fichier CSV [#le-fichier-csv]

* Format **CSV uniquement** (pas de fichier Excel `.xlsx` — exporte ton tableur en CSV).
* Un **exemple de fichier CSV téléchargeable** et un panneau d'explications sont fournis dans la fenêtre d'import : pars de cet exemple.
* Les **en-têtes de colonnes sont tolérants** : plusieurs libellés courants sont reconnus pour chaque champ (par exemple « prénom », « prenom », « first name »).

## Étapes [#étapes]

### 1. Préparer le fichier [#1-préparer-le-fichier]

Renseigne au minimum prénom, nom et email de chaque joueur, plus les colonnes facultatives disponibles (poste, date de naissance, etc.).

### 2. Prévisualiser [#2-prévisualiser]

Charge le fichier : FormaPulse analyse chaque ligne **sans rien créer** et t'affiche un récapitulatif :

* lignes valides et lignes en erreur (avec la raison) ;
* **emails déjà utilisés** dans FormaPulse ;
* **postes** reconnus vs postes qui seront créés ;
* **quota restant** de ton abonnement — l'import est bloqué s'il dépasserait ton quota de sportifs.

### 3. Confirmer l'import [#3-confirmer-limport]

Seules les lignes valides sont créées. En club, les joueurs importés sont rattachés à ton club et partagés selon les règles habituelles du staff.

### 4. Récupérer les identifiants [#4-récupérer-les-identifiants]

Les **mots de passe sont générés automatiquement** (aucun email d'activation n'est envoyé). À la fin de l'import, télécharge le **CSV des identifiants** (email + mot de passe par joueur) et transmets-les à tes joueurs — sans ce fichier, ils ne pourront pas se connecter à l'app mobile.

## Erreurs à éviter [#erreurs-à-éviter]

* **Importer un fichier Excel `.xlsx`** : seul le CSV est accepté — fais « Enregistrer sous > CSV » depuis ton tableur.
* **Fermer la fenêtre sans télécharger le CSV d'identifiants** : les mots de passe générés ne sont plus affichables ensuite (il faudra les réinitialiser individuellement).
* **Ignorer la prévisualisation** : c'est elle qui t'évite les doublons d'emails et le dépassement de quota.

## Aller plus loin [#aller-plus-loin]

<Cards>
  <Card title="Ajouter un joueur" href="/docs/joueurs/ajouter-un-joueur" />

  <Card title="Le joueur sur l'app mobile" href="/docs/joueurs/ajouter-joueur-app-mobile" />

  <Card title="Créer une équipe" href="/docs/club-equipes/creer-une-equipe" />
</Cards>
