Custom CSS / JS

Hello, we’ve been a long standing customer of the 1st version of Stoplight and are now using the newer version. Had a couple of questions please as we prepare for the August 30th date in which we understand the older version will be decommissioned.

a) Where can go to edit custom CSS for published documentation? We see the site referenced in Design considerations: splash page, headers and footers, however can’t seem to find where we can edit custom CSS in the newer version.

b) Is there a place we can go to add custom JS? We would like to be able to quickly verify a cookie is present on the site via JS and then redirect if not present. We had grown accustomed to these 2 features in the previous version.

Thank you - Please let us know soon if possible so we can make preparations. Best regards!

Hi @devteam, I wanted to clarify on your reference to the August 30th date. That message is referring only the first version of the Stoplight Studio platform (ie, the one located at stoplight.io/p though it now automatically redirects to the latest version). This version was the first release in the direction of the new Stoplight Platform, but is now deprecated since we have made the official release (plus there was no way to subscribe or publish free-standing documentation in the old version).

To reiterate, the product being decommissioned is a fully separate product than any of the other Stoplight products that are available (we have an article comparing them here for reference), so it is highly unlikely that this should impact you in any way if you are a paying customer.

If you’d still like to move to the latest version referenced in the blog post above, regarding each item:

a) Custom CSS is no longer available as a feature, however we do have basic theming available that should allow you to achieve a specific look and feel depending on your needs.

b) Similarly, custom Javascript is no longer available, however we are planning on exposing integrations for common vendors such as Google Analytics, Intercom, and more.

Also, if you haven’t already, I’d recommend taking a look at roadmap.stoplight.io to see what our plans are over the coming months (and vote on any items that are important).

I hope that helps! Let me know if anything is unclear.

Thanks Ross for the help here. We’re still unclear regarding the versions since we’ve been a paying customer for a while, have the custom JS feature, yet have always accessed stoplight via the URL https://app.stoplight.io at workspace: https://app.stoplight.io/wk/zfHBEdHSriAB8jNdB/rTr6m2zcCEBrcuyr9/EJWhM5yZWuieMnfch/design

Our API documentation is then hosted at / published to: https://incidentiq.api-docs.io/

The article you referenced indicated that only Next had the custom JS so that would seem to indicate we’re on Next. Yet the article indicates Classic lives at https://app.stoplight.io which is where we go to edit API docs so that seems in conflict.

Would you mind shedding some light on which version is planned for decommission and which plan we’re on? We currently pay for 2 plans ( 1 $129/mo PRO plan which is what we consider the original version, and 1 $99/mo Starter plan in which we’re preparing to move to the latest version ).

Date is coming up shortly so any quick turn around on reply would be gratefully received.

Thanks again!

Hi @devteam, sorry for any confusion here!

Regarding:

We’re still unclear regarding the versions since we’ve been a paying customer for a while, have the custom JS feature, yet have always accessed stoplight via the URL https://app.stoplight.io

You are using “Stoplight Classic”. Stoplight NEXT is located at next.stoplight.io.

The article you referenced indicated that only Next had the custom JS so that would seem to indicate we’re on Next. Yet the article indicates Classic lives at https://app.stoplight.io which is where we go to edit API docs so that seems in conflict.

Both Stoplight Classic as well as NEXT support custom JS. It is only the latest version that does not support Javascript. From the referenced comparison article:

Would you mind shedding some light on which version is planned for decommission and which plan we’re on?

Only the first version of the new Studio Platform (originally located at stoplight.io/p) is being decommissioned. This version was only open to community users to get feedback on Studio and the new Git-based documentation workflow.

Classic and NEXT are no longer under active feature development, but will continue to be operated. In any case, if you are a paying customer (which you are) then nothing is changing.

Let me know if anything else is unclear!

1 Like