Draft Screen Management
How to save, track, resume, and manage draft screen registrations in FairAds AI Partner Portal.
When adding new screen inventory, you don't need to finish the entire registration form in one sitting. FairAds AI includes a built-in Draft Management System that automatically saves your progress and lets you resume registration whenever you're ready.
How Auto-Save Works
As you fill out fields in the Screen Registration Wizard, the system continuously monitors form changes and saves state in two places:
- Local Browser Storage (
localStorage): Saves instantaneous form state and completed step identifiers to prevent data loss if your connection drops. - REST API Synchronization (
/api/v1/device-drafts): Debounced background requests automatically sync draft data with the FairAds backend server.
Progress Tracking
Each draft tracks the following state:
- Current Step: The step you were actively editing (e.g.,
locationortechnical). - Completed Steps Array: List of verified steps (e.g.
["basic", "location", "scheduling"]). - Progress Percentage: Calculated as
(completedSteps.length / 6) * 100.
Managing Draft Screens
You can view, resume, or delete unfinished drafts directly from the Device Management page.
1. Opening the Drafts Modal
- Go to Manage > Inventory.
- Click View Draft Screens at the top of the inventory page.
- The Draft Screens Modal opens, displaying a list of all saved drafts.
+-------------------------------------------------------------+
| Draft Screens [X] |
+-------------------------------------------------------------+
| 📺 North Atrium Display |
| Progress: [██████████░░░░░░] 3 of 6 completed (50%) |
| Last Updated: 10 mins ago |
| [Resume Registration] [Delete Draft] |
| |
| 📺 Downtown Billboard #2 |
| Progress: [███████████████░] 5 of 6 completed (83%) |
| Last Updated: 2 hours ago |
| [Resume Registration] [Delete Draft] |
+-------------------------------------------------------------+Resuming & Completing Drafts
Select Draft
In the Draft Screens Modal, locate the screen draft you want to continue and click Resume Registration.
Auto-Restore Wizard State
The registration wizard launches and automatically loads:
- All previously saved form fields across all 6 steps.
- Completed step indicators.
- Focus on the
currentStepwhere you left off.
Final Submission
Complete the remaining steps. On Step 6 (Review), click Submit Screen.
The system executes the completion endpoint (POST /api/v1/device-drafts/:id/complete), converting the draft into an active device in your main inventory table and map view.
Deleting Unwanted Drafts
If a draft registration is no longer needed:
- Open View Draft Screens.
- Click Delete Draft next to the item.
- Confirm deletion in the alert dialog. The draft will be permanently removed from both local storage and backend databases (
DELETE /api/v1/device-drafts/:id).
How is this guide?
Screen Registration Wizard
Step-by-step guide to registering digital screens, billboards, and monitors using the 6-step onboarding wizard.
Hardware & Media Player Setup
Installing, pairing, configuring CMS API integrations, and troubleshooting FairAds Media Player software across supported hardware platforms.