You can customize the instructional video shown to your suppliers on the portal share page. Videos can be configured at two levels: project-wide or per individual portal.

Video URL Requirements

Supported Video Platforms

YouTube
- ✅ Use: https://www.youtube.com/embed/VIDEO_ID
- ❌ Don't use: https://www.youtube.com/watch?v=VIDEO_ID

Vimeo
- ✅ Use: https://player.vimeo.com/video/VIDEO_ID
- ❌ Don't use: https://vimeo.com/VIDEO_ID

Custom hosting
- Direct MP4 links work: https://your-cdn.com/videos/tutorial.mp4

Configuration Levels

Project-Level Video (Default for All Portals)

Set a default video that applies to all supplier portals in your project.

Steps:

1. Go to Projects in the admin interface
2. Select your project
3. Scroll to Help config field
4. Add or update the JSON configuration:
5. Click Save

{
    "portal_video_url": "https://www.youtube.com/embed/YOUR_VIDEO_ID",
    "suppliers_welcome_text": "Welcome to our supplier portal"
  }

All portals in this project will now show your custom video by default.

Portal-Level Video (Override for Specific Suppliers)

Override the project video for a specific supplier portal.

Steps:
1. Go to External Access Portals in the admin interface
2. Select the portal you want to customize
3. Scroll to Help config field
4. Add or update the JSON configuration:
5. Click Save

{
    "portal_video_url": "https://www.youtube.com/embed/CUSTOM_VIDEO_ID",
    "suppliers_welcome_text": "Welcome, Supplier ABC!"
  }

This specific portal will now show the custom video instead of the project default.

Priority Order

When a supplier accesses their portal, the system checks for videos in this order:

1. Portal-level video (if configured) ➜ Shows this
2. Project-level video (if configured) ➜ Falls back to this
3. Default system video ➜ Final fallback

Use Cases

Scenario 1: Same Video for All Suppliers

Configure the video at project level only. All suppliers see the same instructional video.

Scenario 2: Different Videos per Supplier

1. Configure a general video at project level (default)
2. Override at portal level for specific suppliers who need different instructions

Scenario 3: Multilingual Videos

Configure different video URLs at the portal level based on your supplier's language or region.

Finding Your YouTube Embed URL

1. Go to your video on YouTube
2. Click Share below the video
3. Click Embed
4. Copy the URL from the iframe code: <iframe src="https://www.youtube.com/embed/rDp3R7n3S2Y" ...>
5. Use https://www.youtube.com/embed/rDp3R7n3S2Y in the configuration

Troubleshooting

Video doesn't appear:
- Check that you're using an /embed/ URL for YouTube
- Verify the video is publicly accessible (not private)
- Ensure the JSON syntax is correct (no missing quotes or commas)

Video appears on some portals but not others:
- Portal-level configuration overrides project-level
- Check if the specific portal has its own portal_video_url configured

Need to remove a custom video:
- Simply delete the portal_video_url line from the help_config JSON
- The system will fall back to the next level (project default or system default)

Example Configurations

Minimal Configuration

{
 "portal_video_url": "https://www.youtube.com/embed/abc123"
}

Full Configuration

{
 "portal_video_url": "https://www.youtube.com/embed/abc123",
 "suppliers_welcome_text": "Welcome! Please watch this video before uploading your product data.",
 "hide_project_config": false
}