Procisely User Guide
How to create short URLs, generate QR codes for machine stickers, and manage redirects using Procisely.
What is Procisely?
Procisely is PSI’s URL shortener. It turns long URLs into short, branded links like procisely.com/S9820. The primary use case is QR code stickers on shipped machines — a customer scans the sticker and is taken directly to their machine’s portal page, documentation, or support form.
Key concepts:
- Redirect — A short URL that sends visitors somewhere else.
procisely.com/supportredirects toprogressivesurface.com/support. - Pattern Rule — An automatic rule that handles entire groups of slugs. The SPN rule routes any
procisely.com/S####to the asset portal without creating individual redirects. - Template — A shortcut for creating redirects. Pick “Asset Customer Portal”, enter a serial number, and the redirect is auto-created with the right destination.
- Slug — The short part after
procisely.com/. Forprocisely.com/S9820, the slug isS9820.
Accessing Procisely Admin
- Go to portal.progressivesurface.com (requires VPN or onsite network)
- Sign in with your PSI Microsoft account if prompted
- Click Procisely in the top navigation bar
- You’ll land on the Procisely Dashboard
Note: You must be connected to the PSI network (onsite or VPN) to access the admin interface. The redirect engine at procisely.com is publicly accessible — that’s by design.
Dashboard
The dashboard shows:
- Stats — Total links, active links, total clicks, categories in use
- Default Behavior — How procisely.com handles bare URLs, unknown slugs, and inactive redirects (e.g.,
procisely.com→www.progressivesurface.com) - Active Pattern Rules — Automatic routing rules currently in effect, with descriptions, regex patterns, and worked examples
- Recent Activity — The last 10 modified redirects
- Navigation Cards — Quick access to all Procisely features
Creating a Redirect
From Template (Recommended for Machine Stickers)
The fastest way to create a redirect for a machine:
- Go to Redirects > click New Redirect
- Choose From Template mode
- Select “Asset Customer Portal” from the template dropdown
- Enter the serial number (e.g.,
S9820) - The slug and destination auto-fill based on the template
- Click Save
- Done —
procisely.com/S9820now redirects to the asset portal
Custom Redirect
For non-standard links (campaigns, internal tools, etc.):
- Go to Redirects > click New Redirect (or navigate to
/procisely/redirects/new) - Choose Custom mode
- Enter:
- Slug — The short URL path (e.g.,
spring2026). Letters, numbers, and hyphens only. - Destination URL — Where it should redirect to (e.g.,
https://progressivesurface.com/promotions/spring-2026) - Category — Choose: asset, support, campaign, internal, or custom
- Label — A human-readable description (optional but helpful)
- Slug — The short URL path (e.g.,
- The preview shows what the full URL will look like
- Click Save
From Template
- Go to Redirects > New Redirect
- Choose From Template mode
- Select a template
- Enter the variable value (usually a serial number)
- The slug and destination auto-fill based on the template
- Click Save
Managing Redirects
Redirect List
Go to Redirects to see all existing redirects. You can:
- Search — Type in the search box to find redirects by slug, label, or destination
- Filter — Use the Category dropdown and Active/Inactive toggle
- Sort — Click any column header to sort
- Toggle Active/Inactive — Click the status toggle on any row to enable or disable a redirect
- Edit — Click a redirect row to open the editor
- Delete — Click the delete button on a row (with confirmation)
- Export — Click “Export CSV” to download the current filtered view
Bulk Operations
Select multiple redirects using the checkboxes, then use the bulk action buttons to activate, deactivate, or delete them all at once.
Bulk Import (Onboarding New Machines)
When shipping a batch of machines, you can create all their redirects and QR codes in one step.
Template Import (Recommended)
- Go to Bulk Import
- Select the Template Import tab
- Choose a template (e.g., “Asset Customer Portal”)
- Enter serial numbers — one per line or comma-separated:
S9820 S9821 S9822 S9823 - Preview shows what will be created
- Click Import
- After import, click Download QR Codes to get a ZIP file of all QR code images
CSV Import
- Go to Bulk Import
- Select the CSV tab
- Upload a CSV file with columns: slug, destination, category, label
- Map columns if needed
- Preview and import
QR Code Generation
Single QR Code
- Go to QR Generator (or click the QR icon on any redirect)
- Select a redirect
- Configure:
- Size — 128px to 2048px (use 512px+ for print)
- Format — PNG (for print) or SVG (for web/scaling)
- Logo — Toggle PSI logo overlay in the center
- Click Download
Batch QR Codes
- Go to QR Generator
- Select multiple redirects using checkboxes
- Configure size/format/logo
- Click Download ZIP — you get a ZIP file with one QR image per redirect
Print Specifications for Machine Stickers
| Setting | Recommended Value |
|---|---|
| Size | 512px or larger |
| Format | PNG |
| Error Correction | Level H (30%) — enabled automatically when logo is on |
| DPI | 300 minimum for a 1” sticker |
| Logo | On — adds PSI branding and increases error correction |
Pattern Rules
Pattern rules automatically handle groups of slugs without creating individual redirect records.
Example: The default SPN pattern rule ^S\d{4}$ matches any slug that starts with S followed by 4 digits. This means procisely.com/S9820, procisely.com/S1234, procisely.com/S0001 all redirect to the asset portal automatically.
Managing Pattern Rules
- Go to Pattern Rules
- Rules are listed in priority order — first match wins
- Create — Click “New Rule”, enter a name, regex pattern, destination template, and category
- Test — Use the live tester to enter sample slugs and see if they match
- Reorder — Use the up/down arrows to change priority (lower number = higher priority)
- Disable — Toggle a rule off without deleting it
How Pattern Rules Interact with Redirects
If both a pattern rule and an explicit redirect exist for the same slug, the explicit redirect always wins. This lets you set up a general rule for all SPNs but override specific machines with custom destinations.
Templates
Templates are shortcuts for creating redirects. They define the slug format and destination pattern so you only need to enter one value (usually a serial number).
Default Templates
| Template | You Enter | Creates |
|---|---|---|
| Asset Customer Portal | Serial (e.g., S9820) | procisely.com/S9820 → portal asset page |
| Recalibration Request | Serial | procisely.com/recal-S9820 → recalibration form |
| Documentation Library | Serial | procisely.com/docs-S9820 → machine docs |
| Campaign Landing Page | (custom slug) | Any slug → any URL |
| Internal Tool Link | (custom slug) | Any slug → any URL |
Creating Custom Templates
- Go to Templates
- Click New Template
- Enter:
- Name — Display name (e.g., “Warranty Registration”)
- Slug Pattern — How the slug is formed. Use
{serial}as a placeholder (e.g.,warranty-{serial}) - Destination Pattern — Where it redirects. Use
{serial}for the variable part (e.g.,https://portal.progressivesurface.com/warranty?asset={serial}) - Default Category — auto-assigned when using this template
- Test with a sample serial to preview the result
- Save
Analytics
Go to Analytics to see redirect usage data.
- Click Timeline — Bar chart showing daily clicks over the selected date range
- Top Redirects — The 20 most-clicked redirects
- Category Breakdown — Click distribution across categories (asset, support, campaign, etc.)
- Date Range — Use the quick-select buttons (7d, 14d, 30d, 90d) or set custom dates
Common Workflows
Ship a New Machine
- Redirects > New Redirect > From Template > “Asset Customer Portal” > enter serial > Save
- QR Generator > select the new redirect > Download PNG with logo
- Print sticker, affix to machine
Ship a Batch of Machines
- Bulk Import > Template Import > “Asset Customer Portal”
- Paste serial numbers
- Import > Download QR Codes ZIP
- Print all stickers
Create a Campaign Link
- Redirects > New > Custom mode
- Slug:
spring2026, Destination: your landing page URL, Category: campaign - Save
- Share
procisely.com/spring2026in marketing materials
Create an Internal Shortcut
- Redirects > New > Custom mode
- Slug:
wiki, Destination:https://wiki.progressivesurface.com, Category: internal - Save
- Share
procisely.com/wikiwith the team
Decommission a Machine
- Redirects > find the machine’s redirect > toggle to Inactive
- The QR sticker will now redirect to a “link inactive” page instead of 404
Troubleshooting
”I created a redirect but it’s not working”
- Check that the redirect is Active (green dot in the list)
- Check for typos in the slug — slugs are case-insensitive (
S9820ands9820are the same) - If using a pattern rule, test it with the live tester on the Pattern Rules page
- Allow a few seconds for DNS/caching if you just created it
”The QR code scans but goes to the wrong page”
- Check the destination URL in the redirect editor
- If using a pattern rule, an explicit redirect may be overriding it (explicit always wins)
- Check if there’s a typo in the destination URL
”I can’t access the admin interface”
- You must be on the PSI network (onsite or VPN)
- Sign in with your PSI Microsoft account
- Contact IT if you get a 403 (you may need the Procisely.Admin role)
“How do I know if a QR sticker is being scanned?”
- Go to Analytics — click data appears within seconds of a scan
- You can also check the click count on any individual redirect in the list
Technical Details
For developers and IT staff, see the full technical documentation:
- Architecture, security, API reference: Procisely wiki page
- Redirect engine source: ProgressiveSurface/procisely-redirect
- Admin UI source: Part of ProgressiveSurface/psi-portal