Admin
Marketplace
Screen guide
Before you start
Use an administrator account with permission to manage this feature. The feature also needs to be enabled for this installation and plan.
Open this feature
- Open /settings/marketplace on your site.
Steps
Choose a task
Create or update: Install package / Installing...
- Open /admin/marketplace on your application domain, using the administrator account for this task.
- Find the form containing Purchase code, Module ZIP. Complete the relevant fields using the table below. Fields can appear or change after you select an option.
- Use the button shown for the current state: Install package, Installing.... Creation and editing can show different labels; submit the form once.
- If the application identifies a missing or invalid field, correct that field and submit again. If an external request or payment has an uncertain outcome, check its history before repeating it.
| Field | What to enter or choose |
|---|---|
| Purchase code | Enter the purchase code for this task, using the help or example shown by the form. |
| Module ZIP | Choose a file from your computer. Accepted types: .zip. |
Use Update
- Open /admin/marketplace on your application domain, using the administrator account for this task.
- Select the intended record or item first and review its displayed values. There is no separate input form described for this control.
- Select Update. Check the current record, recipients, amount or destination before confirming when those values apply.
- If the application identifies a missing or invalid field, correct that field and submit again. If an external request or payment has an uncertain outcome, check its history before repeating it.
Use Rescan
- Open /admin/marketplace/packages on your application domain, using the administrator account for this task.
- Select the intended record or item first and review its displayed values. There is no separate input form described for this control.
- Select Rescan. Check the current record, recipients, amount or destination before confirming when those values apply.
- If the application identifies a missing or invalid field, correct that field and submit again. If an external request or payment has an uncertain outcome, check its history before repeating it.
Create or update: Install package / Installing...
- Open /admin/marketplace/packages on your application domain, using the administrator account for this task.
- Find the form containing Purchase code, Module ZIP. Complete the relevant fields using the table below. Fields can appear or change after you select an option.
- Use the button shown for the current state: Install package, Installing.... Creation and editing can show different labels; submit the form once.
- If the application identifies a missing or invalid field, correct that field and submit again. If an external request or payment has an uncertain outcome, check its history before repeating it.
| Field | What to enter or choose |
|---|---|
| Purchase code | Enter the purchase code for this task, using the help or example shown by the form. |
| Module ZIP | Choose a file from your computer. Accepted types: .zip. |
Use Upgrade version
- Open /admin/marketplace/packages on your application domain, using the administrator account for this task.
- Select the intended record or item first and review its displayed values. There is no separate input form described for this control.
- Select Upgrade version. Check the current record, recipients, amount or destination before confirming when those values apply.
- If the application identifies a missing or invalid field, correct that field and submit again. If an external request or payment has an uncertain outcome, check its history before repeating it.
Use Upload new version
- Open /settings/marketplace and select the record you want to work with. Its detail/edit address follows /admin/marketplace/catalog/{slug}. Use the application’s record link; do not type a placeholder such as {id}.
- Find the form containing Module ZIP. Complete the relevant fields using the table below. Fields can appear or change after you select an option.
- Select Upload new version. Check the current record, recipients, amount or destination before confirming when those values apply.
- If the application identifies a missing or invalid field, correct that field and submit again. If an external request or payment has an uncertain outcome, check its history before repeating it.
| Field | What to enter or choose |
|---|---|
| Module ZIP | Choose a file from your computer. Accepted types: .zip. |
Use Update to :version
- Open /settings/marketplace and select the record you want to work with. Its detail/edit address follows /admin/marketplace/catalog/{slug}. Use the application’s record link; do not type a placeholder such as {id}.
- Select the intended record or item first and review its displayed values. There is no separate input form described for this control.
- Select Update to :version. Check the current record, recipients, amount or destination before confirming when those values apply.
- If the application identifies a missing or invalid field, correct that field and submit again. If an external request or payment has an uncertain outcome, check its history before repeating it.
Use Save changes
- Open /settings/marketplace on your application domain, using the administrator account for this task.
- Find the form containing Auto-update status. Complete the relevant fields using the table below. Fields can appear or change after you select an option.
- Select Save changes. Check the current record, recipients, amount or destination before confirming when those values apply.
- If the application identifies a missing or invalid field, correct that field and submit again. If an external request or payment has an uncertain outcome, check its history before repeating it.
| Field | What to enter or choose |
|---|---|
| Auto-update status | Required. Enter the auto-update status for this task, using the help or example shown by the form. |
Fields and choices
Field descriptions appear beside each task above so that separate forms are not mixed together.
Check the result
- Stay in the same account/workspace and reopen the intended record or result screen.
- For saved settings, compare the displayed values with the choices you made. For filters and previews, check the current result scope.
- For queued or external work, inspect its status/history and provider result where applicable. A successful save does not by itself prove message delivery, publication, payment completion or provider approval.
Common problems
| Problem | What to check |
|---|---|
| The screen or action is missing | Check the correct administrator account, role, enabled app and plan. A hidden action is not fixed by typing an internal endpoint. |
| A field is rejected | Read its validation message, choose from the offered options and check the relevant format or limit. Do not substitute a database ID for a displayed choice. |
| A list is empty | Check the selected workspace, search text, date range and status filters. Clear one filter at a time before concluding that records are missing. |
| A request is still pending | Check its status/history before repeating it. For messages, publishing, imports and payments, a submitted request can finish later or fail separately. |
Technical reference
Role-scoped source references
Pinned commit: 40d27448e4517301d3d8f5a27ca0c7531c51f136
- modules/AdminMarketplace/Http/Controllers/AdminMarketplaceController.php
- modules/AdminMarketplace/Livewire/MarketplaceIndex.php
- modules/AdminMarketplace/Livewire/MarketplacePackages.php
- modules/AdminMarketplace/Livewire/MarketplaceProduct.php
- modules/AdminMarketplace/Livewire/MarketplaceSettings.php
- modules/AdminMarketplace/resources/views/index.blade.php
- modules/AdminMarketplace/resources/views/packages.blade.php
- modules/AdminMarketplace/resources/views/product.blade.php
- modules/AdminMarketplace/resources/views/settings.blade.php
Source-only route information
| Method | Source-default route |
|---|---|
| LIVEWIRE | /settings/marketplace |
| LIVEWIRE | /admin/settings/marketplace |
| GET | /admin/marketplace |
| GET | /admin/marketplace/packages |
| GET | /admin/marketplace/catalog/{slug} |
| GET | /admin/marketplace/dashboard/update-notice |
| POST | /admin/marketplace/rescan |
| POST | /admin/marketplace/install |
| GET | /admin/marketplace/storefront/cart |
| POST | /admin/marketplace/storefront/cart/items |
| DELETE | /admin/marketplace/storefront/cart/items/{itemKey} |
| DELETE | /admin/marketplace/storefront/cart |
| POST | /admin/marketplace/{package:id_secure}/update |
| DELETE | /admin/marketplace/{package:id_secure} |
Unmapped fields — not user instructions
These fields belong to this role’s source handler, but their screen labels were not confirmed.
| Source key | Handler |
|---|---|
| marketplace_auto_update_status | modules/AdminMarketplace/Livewire/MarketplaceSettings.php |
| install_method | modules/AdminMarketplace/Http/Controllers/AdminMarketplaceController.php |
| purchase_code | modules/AdminMarketplace/Http/Controllers/AdminMarketplaceController.php |
| module_zip | modules/AdminMarketplace/Http/Controllers/AdminMarketplaceController.php |
| product_id | modules/AdminMarketplace/Http/Controllers/AdminMarketplaceController.php |
| license_type | modules/AdminMarketplace/Http/Controllers/AdminMarketplaceController.php |
| quantity | modules/AdminMarketplace/Http/Controllers/AdminMarketplaceController.php |