Stacks allow you to group images within your account, for easy organisation. Think of a Stack in Maiko, as you would an actual stack of snapshots on your desk.

How do I view my Stacks?

Simply log in to your account. Your account overview always displays an overview of all your Stacks. If you are already logged in to your account, but are not on the account overview page, click on your account name, in the top left corner of the interface, to be brought back there.

By default, the last image uploaded to each Stack will be used as its thumbnail. If you prefer a fixed cover, open the Stack, and alt+click on the thumbnail you feel best represents its contents.

Creating stacks

You must be logged in to Maiko to create a new Stack. On the account overview page, simply click on the big red + button next to the Stacks section header. A dialogue will appear, asking you to assign a name to the Stack. Enter the name you want, and click on Create.

Please note that certain plans feature a finite number of Stacks. If the + button has turned grey, this means you have already created as many Stacks as your plan allows. You will need to upgrade to a bigger plan to create new Stacks, or shuffle your images around to free up one of your allotted Stacks.

Stack Settings

All freshly created Stacks behave in the same way, but you can customise the behaviour of your Stacks to better fit your workflow. To access Stack settings, start by opening the Stack. Then, click on the red cog located next to the Stack title. A drawer will open, listing all the settings you can change. Once you are happy with your changes, click on the green Save button to close the drawer and return to the Stack itself.

1) Title

This is the title of the Stack. It appears in your account overview, and at the top of the Stack page itself. It is for your eyes only, and can be changed to anything that makes sense to you.

2) Background

This sets the colour (in Hex format) you want to see behind the transparent areas of files stored in this Stack. It will be used for previews, and whenever you request a file containing transparent areas in a format that does not support transparency. (For example, when requesting a transparent PNG or PSD file as a JPEG file.)

More information about calling files in different formats can be found in our URL API documentation. If you are unfamiliar with the Hex colour format, click on the colour swatch to bring up a colour picker, that will fill the appropriate value for you based on your visual selection.

3) Domains

This is a list of all the domains that are allowed to ask for new versions of your images by using the URL API. Enter as many domains as you wish, separated by a space. Restricting access to a list of known domains can help safeguard against unauthorised use of your Maiko account, such as attempts to export high-resolution images from the source files it contains. Do note that the images you have already published through your account interface, or the URL API, and that are already being served by Maiko, are always public.

If this field is left blank, then everybody will be able to call for your images, provided they know or guess the URL.

4) Presets

Maiko allows you to scale, crop, and export your images on-the-fly by using simple URLs. Presets are a combination of size, format, and crop method that are set and stored together, so that you can reuse them conveniently with the images stored in your Stack.

To create a Preset, start by giving it a name. Then, enter the width and height of the destination image you want to create. Use the remaining drop-down menus to decide how your image should be cropped, the format in which you want it to be exported, and the resolution at which Maiko should export it. For more information about what these options do, please read our URL API documentation. Click on the green Save button to add your Preset.

By default, accessing a Preset will paste a direct link to the scaled, cropped and exported image into your clipboard. However, if you would rather Maiko provided you with a ready snippet of custom code, you can enter it within the Clipboard Copy section. Simply type in the code you want Maiko to remember, using any of the following placeholders: {{url}}, {{width}}, {{height}}, {{title}} and {{https_url}}. We have included two examples to get you started, which you can access by clicking on the HTML or Markdown links right above these fields.

To edit an existing Preset, simply click on its title in the list. To delete a Preset, simply click on the blue x button standing next to its name in the Presets list.

Once created, your Presets will appear next to the expanded preview of each image in your Stack.

Simply click on the Preset title to copy the Preset link to your clipboard, as configured when the Preset was created. Clicking on the grey window icon will open a new Maiko window showing both the image and the snippet of code generated by the Preset.

5) Stack access controls

Stacks are private by default: only you can edit their contents. If you want to allow others to access your Stack, enter their email address and press return. Maiko will send them an email inviting them to create an account, and log in to your Stack. These users will be able to edit the images contained in your Stack. However, they will not be able to invite other users, or change the Stack settings themselves.

To revoke somebody’s access to your Stack, simply locate their address in the list, and click on Remove. Removing someone from the list takes effect immediately.

Please note that this list only pertains to administrative access to your Stack, not access to your images over the Web. Also note that the number of users you can share your Stacks with depends on your current plan. If you have reached the maximum number of users allowed by your plan, you will need to upgrade to a bigger plan, or remove an existing user before you can add somebody new.