Documentation – BC Navigator

Quick Start

Get BC Navigator running in under 3 minutes.

Install the extension Add BC Navigator to Chrome or Edge from the Web Store. The extension works immediately after installation — no setup required to start your 14-day trial.
Open your BC Base URL Navigate to any page in Business Central and copy the URL from your browser's address bar — everything up to (and including) the trailing slash after your tenant ID or server name.
Set your Base URL in Options Press Alt+W to open the popup, click the settings icon (⚙), then go to Connection. Paste your Base URL and enter your Company Name.
Navigate Press Alt+W anywhere, type a prefix like SO and press Enter. You're navigating BC at keyboard speed.

Your 14-day trial gives you full access to all Pro features — no license key needed. After the trial, activate a Free or Pro license in Options → License.

Base URL format

Type	Example Base URL
SaaS (cloud)	`https://businesscentral.dynamics.com/your-tenant-guid/`
On-premises	`https://bc.yourcompany.com/BC/`

The Base URL must end with a trailing slash /. The Company Name is entered separately in the environment settings.

Command Reference

Press Alt+W to open the command palette, then type any of the following patterns.

Example	What it does
`SO`	Open the Sales Orders list (no filter)
`SO 1234`	Filter to a matching record
`SOL ada*`	Wildcard filter — matches anything starting with "ada"
`SOL ada\|rel`	OR filter — matches "ada" or "rel"
`SO 1001,1002`	Batch — opens one tab per value (max 5)
`SO+`	Create mode — opens a blank new document
`!TEST SO 1234`	Switch to the TEST environment for this navigation Pro
`?` · `? SO`	Browse all prefixes. Type after `?` to filter by name.

Keyboard shortcuts

Key	Action
`Alt+W`	Open the command palette
`Enter`	Navigate to matched page
`Alt+Enter`	Navigate (inverts "open in new tab" setting)
`↑ / ↓`	Browse through navigation history
`Esc`	Close the palette

Special characters

Char	Example	Description
`?`	`? SO`	Browse all prefixes, optionally filter by name
`!`	`!TEST SO`	Switch environment for this navigation (Pro only)
`+`	`SO+`	Create mode — opens a blank new document
`*`	`SOL ada*`	Wildcard — matches any characters at this position
`\|`	`SOL a\|b`	OR filter — matches either condition
`,`	`SO 1,2,3`	Batch — opens one tab per value (max 5)

Environments

Environments let you navigate between multiple BC instances — for example PROD, TEST, and DEV — without changing your settings each time.

Setting up environments

Open Options → Connection Each environment has its own Base URL and Company Name. The default environment is used for all navigation unless overridden.
Add an environment Click Add Environment, give it a name (e.g. "TEST"), and enter the Base URL and Company Name for that BC instance.
Switch environments in the popup Use !ENV PREFIX value to navigate using a named environment for a single navigation, e.g. !TEST SO 1234.

Enable Use active environment in Options → Connection to automatically detect the active environment based on your current BC tab URL.

All plans (Trial, Free, Pro) support multiple environments. The !ENV syntax and auto-detection work the same across all plans.

The default environment is license-bound and cannot be changed while a license is active. To change it, deactivate your license first. Additional environments must belong to the same registered domain as your license binding.

Admin Config Sync Pro

Admins can push a central configuration — environments, company name, and prefix mappings — to all Pro installations in their organization. Employees load it with one click.

Setup (Admin)

Activate a Pro license Admin Config Sync requires a Pro license. After activation, the Admin Config Sync section appears in Options → License.
Generate an admin token Click Generate Token. Copy the token immediately — it is shown only once. Store it securely (e.g. your password manager). The token is required to push configuration updates.
Enter the token and push Paste the token in the Admin Token field and click Save Token. Configure your environments, company name, and prefix mappings, then click Push to all users.

The same admin token works on any device with the same Pro license key. You do not need to generate a new token per device.

Loading defaults (Employees)

Open Options → Connection A "Load Company Defaults" banner appears at the top if your admin has pushed a configuration.
Click "Load Company Defaults" Environments and prefix mappings are replaced with the admin configuration. Your personal overrides (if any) are preserved unless you confirm the replacement.

What gets synced

Field	Behavior
Environments (Base URL + Company Name)	Always replaced by admin config. Shown as "Managed by Admin" (read-only).
Prefix mappings	Replaced only if user has not locally modified them.

License & Activation

Plan overview

Plan	Price	Activations	Use
Trial	Free, 14 days	—	All features. Starts automatically on installation. No license key needed.
Free	€0	Up to 5	All features. Personal & non-commercial only. Requires license key after trial.
Pro	From €89/year	Unlimited	All features + Admin Config Sync. Commercial use permitted.

Free and Pro have identical navigation features. The difference is activation count, permitted use, and Admin Config Sync (Pro only).

Activating a license

Set your Base URL first Go to Options → Connection and enter your BC Base URL. The license is bound to your BC tenant URL on first activation — test before activation!
Open the License tab Go to Options → License, paste your license key and click Activate.
Confirm the tenant binding A confirmation dialog shows the tenant URL that will be permanently bound to your key. Verify it is correct and click Confirm.

Tenant binding is permanent. The first activation locks the license to your BC tenant (e.g. yourcompany.com). Subsequent activations on any device at the same tenant work without issue. Activating with a different tenant URL will be blocked.

Getting a Free license

After the trial expires, get a free license key at bcnavigator.app/pro (€0). Activate it in Options → License. Free licenses allow up to 5 activations and are for personal, non-commercial use.

Upgrading to Pro

Purchase a Pro license at bcnavigator.app/pro, then go to Options → License and enter your Pro key. The old key is automatically deactivated — no manual step required.

Multi-device use

One Pro license covers all employees at your BC tenant — activate on as many devices as needed using the same key. Free licenses are limited to 5 total activations across all devices.

Troubleshooting

Problem	Cause	Fix
"Tenant mismatch" on activation	The license key is already bound to a different tenant URL.	The error message shows the bound URL. If it is wrong (e.g. activated with a test instance), contact support@bcnavigator.app to correct the binding.
"Activation limit reached"	The Free license has a 5-device limit and all activations are used.	Upgrade to Pro (higher activation limit) at bcnavigator.app/pro.
Extension opens BC but lands on wrong page	Base URL missing trailing slash, or Company Name is incorrect.	In Options → Connection: Base URL must end with `/`. Company Name must match exactly (case-sensitive) as shown in the BC URL.
Extension locked after trial ended	14-day trial expired with no license activated.	Activate a Free ($0) or Pro license in Options → License. Get a Free license at bcnavigator.app/pro. All features continue to work after activation.
Admin token is lost	Regenerating requires the current token. If it is still stored in the extension (visible in Options → License), regeneration works automatically.	If the token is still visible in the extension: click Generate New Token — the extension sends the current token automatically and issues a new one. If the token is truly gone (storage cleared, Chrome account lost): contact support@bcnavigator.app for manual reset.
Alt+W shortcut does not work	Another extension or system shortcut is using `Alt+W`.	Go to `chrome://extensions/shortcuts` (or `edge://extensions/shortcuts`) and change the BC Navigator shortcut.
Extension cannot open BC page (CSP error)	Your BC instance blocks navigation from extension contexts via Content Security Policy.	Enable Open in new tab in Options → Connection. BC opens as a regular tab instead of from the popup context.

Still stuck? Email support@bcnavigator.app and include your BC Navigator version (visible in chrome://extensions) and a description of the issue.

FAQ

What happens when my trial ends?

After 14 days without a license, the extension shows an activation screen. Activate a Free license ($0, from bcnavigator.app/pro) to continue with all features for personal use, or a Pro license for commercial use and unlimited activations. Your navigation history and settings are preserved.

How do I upgrade from Free to Pro?

Purchase a Pro license at bcnavigator.app/pro, then open Options → License and enter the new Pro key. Your old Free key is automatically deactivated — no manual steps required. The tenant binding transfers to the new key.

Can I use one license on multiple devices?

Yes. One Pro license covers your entire BC tenant — all employees activate with the same key, with no activation limit. Free licenses allow up to 5 activations total across all devices.

What is the tenant binding and why does it exist?

The tenant binding ties your license key to your company's BC domain (e.g. yourcompany.com) on first activation. This prevents license sharing between unrelated organizations. The binding covers all subdomains and BC environments at that domain, so PROD, TEST, and DEV instances all work with one key.

Does it work with on-premises Business Central?

Yes. Enter your on-premises Base URL in Options → Connection, for example https://bc.yourcompany.com/BC/. The extension works identically for on-prem and SaaS BC.

Is navigation history synced across devices?

No. History is stored locally on each device (not synced) for privacy. Settings and prefix mappings sync across devices via Chrome's built-in sync storage.

My admin pushed a config but I don't see "Load Company Defaults" — why?

The banner only appears for Pro license holders (not trial or free). Also, remote config is cached for up to 4 hours — reload Options after a short wait and the banner should appear. If not, contact your admin to verify the config was pushed successfully.