editOrganizationProfile
Edit organization details such as legal name, addresses, and contact information
Overview
The editOrganizationProfile widget provides a complete interface for editing organization profile information. This widget includes:
- Organization details (legal name, alternate name, etc.)
- Contact information (addresses, emails, phones, web addresses)
- Custom profile fields
- Real-time validation
- Resource deletion capabilities
Use this widget to build self-service organization editors, company profile pages, or membership management interfaces.
Authentication
This widget requires widget tokens for security. Widget tokens provide scoped, temporary access to organization data.
Wicket.widgets.editOrganizationProfile({
accessToken: widgetToken, // Widget token (not regular JWT)
orgId: organizationUuid,
rootEl: container
});See the Widget Authentication Guide for details on generating widget tokens server-side.
Parameters
Prop
Type
Required Resources
The requiredResources parameter allows you to enforce that certain contact information is provided:
{
addresses: "work", // Require one work address
phones: ["mobile", "work"], // Require mobile AND work phone
emails: "primary" // Require primary email
}Events
The widget emits the following events:
WIDGET_LOADED
Fired when the widget has initialized and rendered.
Payload:
Prop
Type
SAVE_SUCCESS
Fired when organization data is successfully saved.
Payload: Same structure as WIDGET_LOADED, with updated values.
DELETE_SUCCESS
Fired when a related resource (address, email, phone, web address) is deleted.
Payload:
Prop
Type
Return Value
Returns a Promise<WidgetLoadResult> that resolves with:
Prop
Type
Example
Wicket.ready(function () {
var widgetRoot = document.getElementById('root');
Wicket.widgets.editOrganizationProfile({
loadIcons: false,
apiRoot: apiRoot,
accessToken: widgetToken,
orgId: "xyz-1234",
lang: "en",
hiddenFields: ["type"],
extraFields: ["parentOrganization"]
}).then(function (widget) {
widget.listen(widget.eventTypes.WIDGET_LOADED, function (payload) {
console.log('widget loaded:', payload);
});
widget.listen(widget.eventTypes.SAVE_SUCCESS, function (payload) {
console.log("save success:", payload);
});
widget.listen(widget.eventTypes.DELETE_SUCCESS, function (payload) {
console.log("delete success:", payload);
});
});
});Try it Live
Configure and test the widget with your Wicket instance.
⚠️ Credentials are stored in your browser's localStorage
Your JWT token (widget token will be generated automatically)