Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
@@ -1,11 +1,60 @@
---
id: admin_portal_tutorials_import-elections
title: Import Elections
title: Import/Export of Elections
---

<!--
SPDX-FileCopyrightText: 2025 Sequent Tech <legal@sequentech.io>
SPDX-License-Identifier: AGPL-3.0-only
-->

Content will be added here soon.
<video controls width="100%">
<source src="./assets/Import and Export Election.mp4" type="video/mp4" />
Your browser does not support the video tag.
</video>

The Sequent Admin Portal provides tools to export election data for backup or auditing and to import existing election configurations to quickly set up new events.

## Exporting an Election

Exporting allows you to save a comprehensive snapshot of your election event.

![Export Menu Selection](./assets/export_menu_selection.png)

1. Navigate to the **Data** menu within your specific Electoral Event.
2. Select the `Export` button.

![Export Password and Instructions](./assets/export_menu_selections.png.png)

3. Choose the data components you wish to include in the export:
* **Include Voters:** Exports the registered voter list.
* **Activity Logs:** Includes a history of administrative actions.
* **Reports:** Includes generated election reports.
* **Tally:** Includes the final vote counts (if available).

:::info
**Security:** If you select sensitive data like voter lists, the system automatically activates **Password Encryption** for the resulting ZIP file.
:::



![Export Password and Instructions](./assets/export_password_display.png)

4. Click `Export` to generate an `.ezip` file.
5. **Save the Password:** A dialog will display a unique decryption password. Copy and store this securely; you will need it to import the file later or to unzip it manually.

## Importing an Election Event

You can import an election event using a previously exported `.ezip` file to recreate an event configuration.

![Import Election Options](./assets/import_election.png)

1. From the sidebar, click the **plus icon** next to "Election Events" or the `+ Create an Election Event` button.
2. Select `Import Election Event`.

![Import File Upload](./assets/import_file_upload.png)

3. Drag and drop your import file or click **Browse** to select it from your local storage.
4. If your file was encrypted, enter the **Decryption Password** you saved during the export process.
5. (Optional) Paste an **Integrity Check (SHA-256)** hash to verify the file has not been tampered with.
6. Click `Import`. The event will now appear in your **Active** elections list.
Original file line number Diff line number Diff line change
Expand Up @@ -8,4 +8,40 @@ SPDX-FileCopyrightText: 2025 Sequent Tech <legal@sequentech.io>
SPDX-License-Identifier: AGPL-3.0-only
-->

Content will be added here soon.
import GoogleVideo from '@site/src/components/GoogleVideo';

<GoogleVideo id="1jyp8LNfbWkeAs6iocX7gca5jpkOJZOhU" />

The Sequent Admin Portal allows for the bulk import of voter data using CSV files, enabling administrators to register large numbers of participants efficiently.

## Step 1: Access the Voter Import Tool

1. Log in to the **Admin Portal** with an account that has administrator privileges.
2. Select the specific **Electoral Event** where you want to import voters.
3. Navigate to the **Voters** menu in the top navigation bar.
4. Select the `Import` button.

![Voters Menu Import Button](./assets/voters_import_button.png)

## Step 2: Prepare and Upload the CSV File

The file to be imported must be a **CSV** (comma-separated values) file containing specific headers such as First Name, Last Name, Area, Elections, and Username (e.g., Voter ID). Additional fields like email or phone numbers can be included as needed.

1. Click **Browse** or drag and drop your CSV file into the upload area.

![CSV Upload Interface](./assets/voters_upload.png)

2. **Integrity Check (Optional):** To ensure the file has not been modified since its creation, you can paste its **SHA-256 hash** into the Integrity Check field.
3. Select `Import` (or `Yes, import without Integrity Check` if skipping the hash).

## Step 3: Verify the Import

The system will process the file, which may take several seconds depending on the number of voters.

1. Once complete, a success message will appear in the **notification box**.
2. To see the new list, refresh the **Voters** menu by switching tabs or clicking the menu again.
3. Use the pagination at the bottom to view the total number of imported voters.

:::info
**Post-Import Actions:** From the voter list, you can still export the registry or use the `Import` button again to add more participants. Note that duplicates will not be accepted.
:::
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading