We have a great update to letter campaigns that launched spring of 2021. Because it's a larger design change we want to give users time to test the new design and make sure all their letter campaigns still look good, so we are moving to letter campaign version four (V4) and preserving version three (V3).
If you aren't heavily customizing Action Network page wrappers or embed codes you shouldn't have any issues. If you do any customization we recommend that you test, test, test to make sure it's a smoother transition to the new design.
Below is a summary of how versioning will work, let us know if you have any questions!
Page wrappers
- If a wrapper is created before the deploy of V4, there is no change to the wrapper unless it’s updated and saved by a user.
- After the deploy all newly updated or created wrappers will be V4 by default.
Embeds
- Live embeds will not be changed by the deploy, giving users time to adjust their code and manually update to V4.
- The embed code for all current and future actions copied from the share sidebar and delivered by the API will update to v4 post deploy.
A few examples below to dig into how this will impact you.
Example #1: You auto generate your page wrappers, and you don’t mess with the code at all. All your wrappers will be fine! Any page wrappers you created before we update letter campaigns will not use the new letter versions unless you make a change in your page wrapper or resave them. Then, we will start using the new letter campaign design for that wrapper. And any new wrappers you create will use the new letter campaign design and make letter campaigns look even better.
Example #2: You create custom page wrappers for your actions. Any wrappers you create before we update letter campaigns will use the old letter campaign version and thus will not change unless you resave them, so you have time to test the new design with your custom wrappers and make sure it looks good, nay great! After you make a change or resave your wrapper, you will start to use the new letter campaign version.
Example #3: You use page wrappers for letter campaigns and go to create a new one after we’ve updated the design. The new page wrapper will reflect the new letter campaign design automatically.
Example #4: You embed your letter campaigns. Any live letter campaign embeds will not be impacted! So if you have a live letter campaign, the embed code you have pasted and perhaps customized in your website won’t change. The embed code in the share sidebar for the action will update to the new design, so if you copy and paste new embed code, you will get the new design, giving you time to test the design with your website to ensure that it looks good, nay great!
Example #5: You embed your letter campaigns and go to create a new one after we’ve deployed the new design. The embed code in the share sidebar reflects the new design, but you can revert to the old design if it doesn’t work with your overall website.
Example #6: You use the API to retrieve letter campaign embed code. The API will display the updated embed code. Existing embeds you are using are not affected (see Example #6) but the API will be showing the new embed version, so take care to make sure it works with where you are embedding.