Skip to main content
More in Learn

Expanding the Crystallize UI With Custom Functionality

Apps allow you to access external custom-built applications (ex. import/export tools) within the Crystallize PIM user interface. If there's a feature you need that we don't have, you can build or find it elsewhere and link it here. These tools can all be kept and accessed inside of Crystallize, which is far more convenient than browsing to each of them individually.

Adding Apps To Your Tenant

Each tenant has its own set of Apps. An external application can be added to Crystallize as an App as long as it's configured to render within an iframe. You’ll need to configure your App’s X-Frame-Options accordingly.

To get started, the Apps feature must first be enabled within Labs. If you're not sure how to do this, you can read more about enabling Labs features.

From the left-hand panel of buttons, click Settings, then click on the Apps label. Click the Add App + button, then specify a name for the App. The identifier field will automatically populate based on the name, but you can change it if you need to. Finally, enter the URL from which the App may be accessed. HTTPS is enforced here.

After an App has been added, you can click the (...) button on the right side of its corresponding label to either edit or delete it.

Accessing Apps

Once one or more Apps have been added to your tenant, there will be an Apps icon on the left-hand side of the screen. Click this to open the main Apps page. When you click the name of an App, it will be rendered within the main frame.

Signature Verification

Requests that Crystallize sends to Apps will be signed with a signature secret that’s unique to your tenant. For improved security, it's highly recommended that you configure your Apps to verify the signatures sent by Crystallize. You can read our documentation on signature verification for more detail on how to do this.

People showing thumbs up

Need further assistance?

Ask the Crystallize team or other enthusiasts in our slack community.

Join our slack community