← All help articlesHELP / TEAM2FA

Add and import authenticator codes

Use a setup key, camera, screenshot, shared screen or an authenticator export.

Add one code

In Codes choose Add Code. Paste an otpauth URI or the setup key, or choose Use Camera, Scan Screen, Paste QR Or Key, or Choose Image. You can also drag an image into the add dialog. Browser camera and screen permissions are requested only when you start scanning. Confirm the service name, account, algorithm, digits and period before saving.

Import several codes

In Settings choose Import Codes for a Google Authenticator export. Choose several QR screenshots together, or add images or camera scans one at a time. If Google Authenticator shows numbered QR parts, add every part before importing. The status shows how many parts were scanned and which images failed. The paste field is only for a full otpauth-migration:// link and can stay empty when you use images. Review the account names, optionally assign a code group, select the entries to keep, and confirm the import. Other authenticator export formats might not be supported.

Protect the setup secret

A QR image and an otpauth URI both contain the long lived setup secret. Images are decoded in your browser and sent to Team2FA only when you save or confirm an import. Remove unprotected screenshots afterward. If a secret was exposed, replace it at the external service.

Ready to continue?

Open the app to follow these steps, or browse another help article.

Open Team2FA ↗ All help articles

Essential session cookies, a local privacy preference, a getting started preference and an install reminder preference support the service. Optional analytics is currently inactive, even if you allow it.