Como mostrar mensagens de erro, sucesso, etc no Magento 2

Ao desenvolver módulos e customizações em lojas Magento, eventualmente vamos querer exibir mensagens de sucesso, erro e avisos aos usuários e administradores da lojas.

Para adicionar mensagens como esta no topo da página, precisamos injetar o gerenciador de mensagens do Magento 2. Ele é representado pela classe abaixo:

\Magento\Framework\Message\Manager

Se você está usando isso em um Controller, eventualmente você está implementando uma classe que herda \Magento\Framework\App\Action\Action. Se este for o caso, não é necessário injetar novamente a classe acima, pois ela já está carregada em $this->messageManager.

E em seguida basta chamar um de seus métodos:

->addErrorMessage
->addSuccessMessage
->addNoticeMessage
->addWarningMessage

Veja alguns exemplos de uso

$this->messageManager->addNoticeMessage('Notice Message Magenteiro');
$this->messageManager->addWarningMessage('Warning Message Magenteiro');
$this->messageManager->addSuccessMessage('Sucesso aos Magenteiros');
$this->messageManager->addErrorMessage('Error Message: Você devia ter feito um curso no Magenteiro. :)');

Isso resultaria nas seguintes mensagens sendo exibidas na loja:

Exemplo completo com Controller

Vamos supor que queremos exibir uma mensagem de erro e redirecionar o usuário para a página anterior. Para isso, bastaria adicionar o código abaixo dentro da action do nosso Controller.

$resultRedirect = $this->result->create(\Magento\Framework\Controller\ResultFactory::TYPE_REDIRECT);

return $resultRedirect->setUrl($this->_redirect->getRefererUrl());

Confira também a série de artigos sobre Controllers disponível aqui no Magenteiro, ou a seção 7 do Magento 2: O Curso. Se você já é aluno, clique aqui para assistir a primeira aula desta seção.

E no Magento 1? Como adiciono as mensagens?

No Magento 1 é parecido e podemos encontrar um exemplo neste outro artigo onde mostrei como criar um formulário de contato no Magento 1.

• Sobre
• Últimos Posts

Ricardo Martins

É desenvolvedor web há 16 anos e um dos primeiros certificados pela Magento no Brasil. Instrutor de mais de 11 cursos Magento (os principais no magenteiro.com/cursos) com mais de 14 mil alunos de 105 países, é também criador do módulo PagSeguro Transparente, usado em mais de 12 mil lojas.

Últimos posts por Ricardo Martins (exibir todos)

• Guest checkout bloqueado na API REST do Magento 2? Confira isso. - 7 de julho de 2026
• Você precisa testar esta plataforma de e-commerce - 9 de fevereiro de 2026
• A hora de montar o seu OnlyFans chegou! Veja 8 ideias pra começar o seu. - 4 de dezembro de 2024